Endpoint · Images

Image Generation

文生图 API。支持多种主流模型，输出可选 URL 或 base64。请求结构和 OpenAI v1/images/generations 一致。

端点

http
POST https://api.aicodedog.com/v1/images/generations

常用模型：nano-banana-pro（Google）、seedream-4-5（字节）、flux-1-1-pro（Black Forest Labs）、gpt-image-1-5（OpenAI）。

最小请求

curl
curl https://api.aicodedog.com/v1/images/generations \
  -H "Authorization: Bearer $AICODEDOG_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "nano-banana-pro",
    "prompt": "一只穿宇航服的橘猫坐在月球上，写实风格，柔和阳光",
    "size": "1024x1024",
    "n": 1
  }'

python
from openai import OpenAI
client = OpenAI(api_key="<KEY>", base_url="https://api.aicodedog.com/v1")

resp = client.images.generate(
    model="nano-banana-pro",
    prompt="一幅富士山前樱花盛开的插画，ghibli 风格",
    size="1024x1024",
    n=1,
)
print(resp.data[0].url)

参数

model（必填）— 模型 slug。
prompt（必填）— 描述。中英文都支持，越具体效果越好。
n — 生成几张，默认 1。一次最多 4 张。
size — 分辨率，常用 1024x1024 / 1536x1024（横）/ 1024x1536（竖）。
quality — standard / hd（部分模型支持）。
style — vivid / natural（部分模型支持）。
response_format — url（默认，临时链接 24 小时有效）/ b64_json（base64，可立即落盘）。
seed — 同 prompt + 同 seed 尝试复现，便于风格对齐（best-effort）。
negative_prompt — 负面提示词（部分模型支持）。

响应

json
{
  "created": 1747291200,
  "data": [
    {
      "url": "https://cdn.aicodedog.com/img/abc123.png",
      "revised_prompt": "A photorealistic orange tabby cat..."
    }
  ]
}

URL 24 小时后失效

默认 response_format=url 返回的是临时签名链接。如果你要长期保存，建议立即下载到自己的对象存储（R2/S3/OSS），或一开始就用 b64_json 直接拿 base64。

提示词建议

**主体 + 风格 + 细节**：先写「画什么」，再写「什么风格」，再写「色调/光线/构图」。
**避免歧义**：「一只猫」可能给一只灰猫——明确写「一只橘色短毛猫」。
**结构化分句**：用句号或逗号断开，模型解析更稳。
**中文风格**：可以指定「水墨」、「工笔」、「ghibli」、「赛博朋克」、「极简线条」等关键词。
**反例**：少用「不要」、「没有」之类的否定，除非用 negative_prompt。