gpt-image-2
模型 ID
gpt-image-2- OpenAI
- 图片
概览
- 模型开发者
- OpenAI
- 支持的协议
scenepond-task
调用这个模型
创建 API Key、充值账户余额，并在调用前确认密钥有权访问这个模型。
复制此模型的完整接口文档，包含全部已公布协议，供 AI 助手读取。
POST
/v1/tasks请求参数
| 参数 | 必填 | 类型 | 说明 | ||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
model | 必填 | string | 使用此处显示的完整公开模型 ID。 约束
| ||||||||||||||||||||||||||||||||||||||||||||
parameters | 必填 | object | 此模型的生成参数。 | ||||||||||||||||||||||||||||||||||||||||||||
仅在提供 parameters 时适用；子字段必填不代表可选的父字段也必填。
| |||||||||||||||||||||||||||||||||||||||||||||||
调用注意事项
- 图片和视频使用同一套任务接口。选择模型后，系统自动选择渠道。
- 每次请求使用 Authorization: Bearer 和 Scenepond API Key 认证；密钥保存在服务器。
- 提交一次并保存 task_id，轮询至 succeeded 或 failed，再通过结果接口下载。
- 上游接受请求后返回任务信息；同步上游可能在返回任务 ID 前完成生成。
- POST 超时后请勿自动重提，任务可能已创建并产生费用。
- 参数和限制因模型而异，只接受此模型列出的字段。
最小调用
1curl --fail-with-body -X POST "https://open.scenepond.ai/v1/tasks" \
2 -H "Authorization: Bearer $SCENEPOND_API_KEY" \
3 -H "Content-Type: application/json" \
4 --data-binary @- <<'JSON'
5{
6 "model": "gpt-image-2",
7 "parameters": {
8 "prompt": "A cat walking on a quiet beach",
9 "count": 1,
10 "size": "1024x1024",
11 "quality": "low"
12 }
13}
14JSON在已安装 cURL 的终端中执行此示例，执行前先设置 SCENEPOND_API_KEY。
响应示例
响应示例仅展示结构；ID、URL 和数值为占位内容。
提交响应
1{
2 "task_id": "task_EXAMPLE",
3 "model": "gpt-image-2",
4 "status": "queued",
5 "progress": 0,
6 "created_at": 1700000000,
7 "finished_at": 0,
8 "error": null,
9 "links": {
10 "self": "/v1/tasks/task_EXAMPLE",
11 "artifacts": "/v1/tasks/task_EXAMPLE/artifacts"
12 }
13}已完成任务的状态
1{
2 "task_id": "task_EXAMPLE",
3 "model": "gpt-image-2",
4 "status": "succeeded",
5 "progress": 100,
6 "created_at": 1700000000,
7 "finished_at": 1700000060,
8 "error": null,
9 "links": {
10 "self": "/v1/tasks/task_EXAMPLE",
11 "artifacts": "/v1/tasks/task_EXAMPLE/artifacts"
12 }
13}生成文件列表
1{
2 "task_id": "task_EXAMPLE",
3 "artifacts": [
4 {
5 "key": "image_0",
6 "type": "image",
7 "content_url": "https://open.scenepond.ai/v1/tasks/task_EXAMPLE/artifacts/image_0/content"
8 }
9 ]
10}后续请求
2. 查询任务状态
每隔几秒查询一次，直到 succeeded 或 failed。
1curl --fail-with-body -X GET "https://open.scenepond.ai/v1/tasks/$SCENEPOND_TASK_ID" \
2 -H "Authorization: Bearer $SCENEPOND_API_KEY"在已安装 cURL 的终端中执行此示例，执行前先设置 SCENEPOND_API_KEY。
3. 获取生成结果
任务 succeeded 后列出结果，并使用 content_url 下载。请勿公开签名 URL。
1curl --fail-with-body -X GET "https://open.scenepond.ai/v1/tasks/$SCENEPOND_TASK_ID/artifacts" \
2 -H "Authorization: Bearer $SCENEPOND_API_KEY"在已安装 cURL 的终端中执行此示例，执行前先设置 SCENEPOND_API_KEY。
接入你的应用
在应用中通过任务 API 提交生成请求，并按任务 ID 获取结果。
模型访问权限和请求限制取决于账户、API Key 与服务配置。