本文将介绍如何集成 SeeDream 图像生成 API，该 API 允许您通过输入自定义参数生成官方的 SeeDream 图像。通过本指南，您将掌握 API 的使用方法，并能轻松实现图像生成与编辑。
环境准备/前置条件
在开始使用 SeeDream 图像生成 API 之前，您需要：
- 注册并登录 Ace Data Cloud 账户。
- 申请 SeeDream 图像生成 API 服务，获取相应的 API 密钥。
详细步骤
申请 API 服务
要使用 API，您需要访问 SeeDream 图像生成 API 页面。进入页面后，点击“获取”按钮，如下图所示：
如果您尚未登录或注册，将自动重定向到登录页面。登录或注册后，您将返回当前页面。
首次申请时，系统将为您提供免费的配额，可以免费使用该 API。
基本使用
在了解 API 的基本用法之前，您需要通过输入prompt（提示）、action（生成操作）和size（图像大小）来获取处理结果。您只需传递一个action字段，值为generate，然后输入提示。详细信息如下：
请求头设置：
accept: 期望的响应格式，设置为application/json以获取 JSON 格式。authorization: 调用 API 的密钥，申请后可选择。
请求体：
{ "prompt": "a white siamese cat", "model": "doubao-seedream-5.0-lite", "image": "https://example.com/image.jpg", "size": "2048x2048" }请求体中包含以下字段：
prompt: 提示文本。model: 生成模型，默认为doubao-seedream-5.0-lite。支持的模型包括多个版本。image: 输入图像信息，支持 URL 或 Base64 编码。size: 指定生成的图像大小，支持两种互斥方法。- 其他字段如
seed,stream,guidance_scale等，可以根据需求选择。
点击“尝试”按钮进行测试，您将得到如下结果：
{ "success": true, "task_id": "25027ba3-0430-4a1b-91c8-d2297f19ba73", "data": [ { "image_url": "https://platform.cdn.acedata.cloud/seedream/3c060029-69b1-406f-a957-fcd55ddc9386.jpg" } ] }图像编辑任务
如果您希望编辑图像，则image参数必须包含要编辑图像的链接。示例代码如下：
import requests url = "https://api.acedata.cloud/flux/images" headers = { "accept": "application/json", "authorization": "Bearer {token}", "content-type": "application/json" } payload = { "model": "doubao-seedream-5.0-lite", "prompt": "编辑内容", "image": ["https://example.com/image.jpg"], "size": "2K", "watermark": False } response = requests.post(url, json=payload, headers=headers) print(response.text)运行后，您将获得类似的结果。
异步回调
由于 SeeDream 图像生成 API 生成图像可能需要较长时间（约 1-2 分钟），如果 API 长时间没有响应，HTTP 请求将保持连接打开，造成额外的系统资源消耗。因此，该 API 还支持异步回调。
您可以在请求中指定callback_url字段，任务完成后，生成的图像结果将通过 POST JSON 发送到您指定的callback_url。
错误处理
在调用 API 时，如果发生错误，API 将返回相应的错误代码和消息。例如：
400 token_mismatched: 请求错误，可能是缺少或无效参数。401 invalid_token: 未授权，令牌无效或缺失。429 too_many_requests: 请求过多，超出速率限制。
错误响应示例
{ "success": false, "error": { "code": "api_error", "message": "fetch failed" } }总结
通过本文，您了解了如何使用 SeeDream 图像生成 API 生成图像。希望本指南能帮助您更好地集成和使用该 API。如有任何问题，请随时联系技术支持团队。
- Ace Data Cloud
- API 文档
- Dify
技术标签：#API #图像生成 #Python #AceDataCloud #技术教程
