跳到主要内容

文生图

这一页帮你用 POST /v1/images/generations 发出第一张图。不想写代码的话，控制台的操练场选图片模型也能直接生成。

完整端点是 https://api.biyuan.ai/v1/images/generations。模型 ID 从模型广场的「图片」分类复制；想确认当前令牌实际可用的模型，调用 GET /v1/models（令牌设置了模型限制时，以这个返回为准）。下面用 gpt-image-2 作示例。

发一条请求​

把 <YOUR_TOKEN> 换成你的令牌（sk- 开头，在控制台令牌管理创建）。

curl https://api.biyuan.ai/v1/images/generations \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <YOUR_TOKEN>" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "一只戴着红围巾的白猫坐在木窗边，清晨阳光打进来，电影感摄影，细节丰富",
    "n": 1
  }'

看返回里的什么​

成功时 data 数组里至少有一张图，取其一即可：

  • data[].url：图片链接
  • data[].b64_json：base64 图片内容。b64_json 是把图片编码成文本的格式（base64），把这段内容解码保存成 .png 即可；多数工具和代码库都支持
  • data[].revised_prompt：部分模型会回填改写后的提示词，可能为空

url 和 b64_json 通常只有一个有值，取决于这个模型返回的是链接还是 base64。

常用参数​

参数作用首次建议
model图片模型名称从模型广场复制
prompt画面描述写清主体、环境、风格
n一次生成几张先用 1
size输出尺寸先省略，用模型默认
quality质量档位（部分模型）基础请求成功后再加

提示词写清主体、环境、风格和画面方向，出图更稳。首次别上大尺寸和一堆参数，先把链路跑通。

排错​

出图失败时，先跑 GET /v1/models 确认目标图片模型可见——看不到多半是当前分组没开放这个模型，而不是接口本身有问题。图片模型不能填进 TRAE、Cursor 这类聊天入口，原因见图片模型。

继续阅读​