RelayDanceDocs / 图像生成
图像生成
通过兼容 OpenAI 的 POST /v1/images/generations 端点，从文字提示词生成图像。请求会直接返回图像 URL，无需轮询。
#模型
| 模型 ID | 系列 | 说明 |
|---|---|---|
| gpt-image-2 | OpenAI | 原生支持最高 4K，图像输出免费 |
在 RelayDance 上图像输出免费: 你只需为输入付费。支持人脸与人像，任务立即开始且无排队。
#API 用法
cURL
terminalbash
curl https://relaydance.com/v1/images/generations \
-H "Authorization: Bearer $RELAYDANCE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-image-2",
"prompt": "A serene Japanese garden with cherry blossoms, watercolor style",
"n": 1
}'Python
image.pypython
import requests, os
response = requests.post(
"https://relaydance.com/v1/images/generations",
headers={
"Authorization": f"Bearer {os.environ['RELAYDANCE_API_KEY']}",
"Content-Type": "application/json",
},
json={
"model": "gpt-image-2",
"prompt": "A serene Japanese garden with cherry blossoms, watercolor style",
"n": 1,
},
)
data = response.json()
print(data["data"][0]["url"])OpenAI SDK
image.tstypescript
import OpenAI from "openai";
const client = new OpenAI({
apiKey: process.env.RELAYDANCE_API_KEY,
baseURL: "https://relaydance.com/v1",
});
const res = await client.images.generate({
model: "gpt-image-2",
prompt: "A futuristic city at dusk, cinematic lighting",
n: 1,
});
console.log(res.data[0].url);#响应
response.jsonjson
{
"data": [
{ "url": "https://..." }
]
}#请求参数
| 参数 | 类型 | 说明 |
|---|---|---|
model | string | 图像模型 ID |
prompt | string | 要生成图像的文字描述 |
n | integer | 要生成的图像数量。默认: 1 |
size | string | 可选的输出尺寸，取决于模型（如 "1024x1024"） |
#获得更好效果的建议
- 具体描述: 在提示词中描述风格、构图、光线和氛围
- 指定风格: 像 "photorealistic"、"watercolor"、"anime" 这样的关键词能强烈影响输出
- 反复迭代: 提示词的细微改动可能大幅改变结果; 生成、调整、再生成
生成的图像很适合作为视频的参考输入: 把 URL 传入视频任务的
metadata.content[] 中。参见图生视频。