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 计费,价格随尺寸、质量和请求的图像数量而变化。 目录会展示每个模型的单次调用价格。
