文档

图像生成

向已收录的图像模型请求一张图像,并读取它返回的 URL 或 base64 载荷。

Requesting an image

图像模型像文本模型一样同步应答 —— 一次请求,一次响应,无需轮询。请求发往 /v1/images/generations,只需要一个模型和一段提示词。

1from openai import OpenAI23client = OpenAI(4    base_url="https://www.realrelay.ai/v1",5    api_key="sk-***",6)78image = client.images.generate(9    model="byteplus/seedream-4-5-251128",10    prompt="A quiet reading room at golden hour",11)1213print(image.data[0].url)
1import OpenAI from "openai";23const client = new OpenAI({4  baseURL: "https://www.realrelay.ai/v1",5  apiKey: process.env.REALRELAY_API_KEY,6});78const image = await client.images.generate({9  model: "byteplus/seedream-4-5-251128",10  prompt: "A quiet reading room at golden hour",11});1213console.log(image.data[0].url);
1curl https://www.realrelay.ai/v1/images/generations \2  -H "Authorization: Bearer $REALRELAY_API_KEY" \3  -H "Content-Type: application/json" \4  -d '{5    "model": "byteplus/seedream-4-5-251128",6    "prompt": "A quiet reading room at golden hour"7  }'

size、quality、 n 和 response_format 都被接受,厂商特定的字段也会原样转发。某个模型支持哪些取值由模型提供方决定而非由我们决定,因此在依赖某个取值之前,请查阅提供方自己的参考文档。

有些已收录的图像模型尚未宣告这个端点,因此它们的目录条目里没有调用示例。这是我们发布内容的缺口,并不代表该模型无法生成图像 —— 在修复期间,请向支持团队索取确切的调用方式。

Reading the response

响应携带一个 data 数组。每个条目要么带一个 url,要么带一个 b64_json 载荷,取决于模型以及 response_format。两种都要处理:我们是把提供方的响应原样透传,而不是做归一化,所以返回 base64 的模型会一直这么返回。

1{2"created": 1754899200,3"data": [4  { "url": "https://..." }5]6}

返回的 URL 属于提供方,而不是我们,且提供方会让它过期。请把它当作一个短命的句柄:一拿到就立刻下载字节,而不要存储这个链接。

大多数图像模型按调用计费而非按 token 计费,价格随尺寸、质量和请求的图像数量而变化。 目录会展示每个模型的单次调用价格。