Docs / 图像生成

图像生成

通过兼容 OpenAI 的 POST /v1/images/generations 端点，从文字提示词生成图像。请求会直接返回图像 URL，无需轮询。

#模型

可使用你密钥模型列表中的任意图像模型 ID，例如 gpt-image-1。调用 GET /v1/models 或浏览模型页面，即可查看你可使用的准确模型 ID。

#API 用法

cURL

terminalbash

curl https://relayrouter.io/v1/images/generations \
  -H "Authorization: Bearer $RELAYROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-1",
    "prompt": "A serene Japanese garden with cherry blossoms, watercolor style",
    "n": 1
  }'

Python

image.pypython

import requests, os

response = requests.post(
    "https://relayrouter.io/v1/images/generations",
    headers={
        "Authorization": f"Bearer {os.environ['RELAYROUTER_API_KEY']}",
        "Content-Type": "application/json",
    },
    json={
        "model": "gpt-image-1",
        "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.RELAYROUTER_API_KEY,
  baseURL: "https://relayrouter.io/v1",
});

const res = await client.images.generate({
  model: "gpt-image-1",
  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" 这样的关键词能强烈影响输出
反复迭代: 提示词的细微改动可能大幅改变结果; 生成、调整、再生成

←LLM / Chat How It Works→