Seedream 5.5 AI

开发者文档

Seedream 5 Pro API 文档

通过本站异步 API 使用 Seedream 5 Pro 生成图片。Seedream 5.5 仍为预览版本，本站尚不可调用。

快速开始

  1. 在工作台的 API 密钥页面创建密钥。
  2. 向 POST /api/v1/images/generate 发送 model=seedream-5-pro 和提示词。
  3. 使用返回的 data.task_id 和同一个 API 密钥，轮询 GET /api/v1/images/status?task_id=TASK_ID。

身份验证

从你的服务端发送 Authorization: Bearer YOUR_API_KEY。无需浏览器登录会话或 Cookie，请妥善保管 API 密钥。

Authorization: Bearer YOUR_API_KEY

接口与请求字段

POST /api/v1/images/generate

发送包含 model、prompt、aspect_ratio 和 resolution（1k 或 2k）的 JSON 请求体。可选 image_urls 接收最多 10 个参考图地址；public 是可选布尔值。响应包含 code、message，以及含 task_id 和 status 的 data。

GET /api/v1/images/status?task_id=TASK_ID

通过 task_id 轮询，响应包含 code、message，以及含 task_id、status、consumed_credits 和 image_urls（图片地址数组）的 data。任务失败时可能包含 error_message。

当前唯一可调用的模型为 seedream-5-pro

任务处理中可继续轮询，完成后读取 image_urls，失败时查看 error_message。

cURL 示例

将命令复制到终端，把 YOUR_API_KEY 替换为你的私密 API 密钥，再将 TASK_ID 替换为首次响应中的 data.task_id。

curl -X POST https://seedream5-5ai.com/api/v1/images/generate -H 'Authorization: Bearer YOUR_API_KEY' -H 'Content-Type: application/json' --data '{"model":"seedream-5-pro","prompt":"一张带有清晰易读文字的咖啡馆海报","aspect_ratio":"1:1","resolution":"1k","image_urls":[],"public":false}'

curl 'https://seedream5-5ai.com/api/v1/images/status?task_id=TASK_ID' -H 'Authorization: Bearer YOUR_API_KEY'