图像生成

Endpoint

POST https://vibetoken.cn/v1/images/generations

兼容 OpenAI 的 Image Generation API。连接会一直保持打开，直到上游模型返回结果（通常为 5–30 秒）。

Request Headers

Header	Value
`Authorization`	`Bearer sk-rb-xxxxxxxxxxxx`
`Content-Type`	`application/json`

Request Body

string

必填

图像模型 ID。例如 google/imagen-4、blackforestlabs/flux-2-pro、ideogram/ideogram-3-0。

string

必填

待生成图像的文本描述。

integer

要生成的图像数量。默认为 1。

string

例如 1:1、16:9、9:16、4:3、3:4。取决于具体模型——并非所有模型都支持此参数。

string

例如 1K、2K、4K。取决于具体模型。

string

例如 hd、standard。取决于具体模型。

string

例如 natural、vivid。取决于具体模型。

string

希望从图像中排除的内容。取决于具体模型。

array

图生图 / 编辑 / 放大 / 重构图 / 混合（remix）类模型必需。每一项可以是公开的 HTTPS URL，也可以是内联的 base64 data: URI（例如 data:image/png;base64,…）——内联图像会在生成前被自动解码并托管，因此无需针对特定 provider 做任何特殊处理。对于超过几 MB 的内容，建议通过 POST /v1/uploads 上传，并传入返回的 URL。

Examples

curl -X POST https://vibetoken.cn/v1/images/generations \
  -H "Authorization: Bearer sk-rb-xxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "bytedance/seedream-4.0",
    "prompt": "A red apple on a white table",
    "aspect_ratio": "1:1",
    "resolution": "1K"
  }'

from openai import OpenAI

client = OpenAI(
    api_key="sk-rb-xxxxxxxxxxxx",
    base_url="https://vibetoken.cn/v1",
)

img = client.images.generate(
    model="google/imagen-4",
    prompt="A red apple on a white table",
    extra_body={"aspect_ratio": "1:1", "resolution": "1K"},
)
print(img.data[0].url)

Response

{
  "created": 1776245700,
  "data": [
    { "url": "https://media.vibetoken.cn/media/<user>/<gen>/0.png" }
  ]
}

当配置了 R2 存储后，VibeToken 会将上游 URL 重新托管到自己的 CDN 上，从而使链接不会过期。

Image-to-image

对于图生图 / 编辑类模型（例如 blackforestlabs/flux-2-pro-i2i、ideogram/ideogram-character-edit），需提供 image_urls：

{
  "model": "blackforestlabs/flux-2-pro-i2i",
  "prompt": "Make it watercolor",
  "image_urls": ["https://example.com/source.jpg"]
}

快速开始

API 参考

Endpoint

Request Headers

Request Body

Examples

Response

Image-to-image

​Endpoint

​Request Headers

​Request Body

​Examples

​Response

​Image-to-image

Endpoint

Request Headers

Request Body

Examples

Response

Image-to-image