跳转到主要内容
GET
/
openai
/
4o-image
/
fetch
cURL
curl --request GET \
  --url https://api.ttapi.io/openai/4o-image/fetch \
  --header 'TT-API-KEY: <api-key>'
{
  "status": "SUCCESS",
  "message": "success",
  "jobId": "5ecc5080-b1d7-4b9f-8184-435e46ebb5cb",
  "data": {
    "prompt": "画一张美女模特该衣服平面照拍摄照片,要求高像素,高逼真度,完美还原衣服所有细节,全身照专业姿势,身材性感,穿着潮流,面带微笑,欧美女性皮肤白皙",
    "referImages": [
      "https://cdn.ttapi.io/demo/2025-03-30/5d17dd5207daeeac86bcecd2d6405a0.jpg"
    ],
    "imageUrl": "https://cdnc.ttapi.io/2025-03-31/cd3f3ce5-06be-4b3a-9aed-014045ca1804.png",
    "quota": "2",
    "finishTime": "2025-03-31 04:25:33",
    "hookUrl": "https://webhook-test.com/b129b43b6619f977b3227387fc290f7d"
  }
}

授权

TT-API-KEY
string
header
必填

授权字段,控制台获取授权信息

查询参数

jobId
string
必填

生成接口同步返回的jobId(支持URL参数/请求体传递)

响应

请求成功

status
enum<string>
必填

任务状态:ON_QUEUE-处理中,SUCCESS-成功,FAILED-失败

可用选项:
SUCCESS,
ON_QUEUE,
FAILED
示例:

"SUCCESS"

message
string | null
必填

响应信息:成功时返回success,失败时返回具体错误原因,处理中返回null

示例:

"success"

jobId
string
必填

任务唯一标识ID,用于查询任务状态/接收回调通知

示例:

"5ecc5080-b1d7-4b9f-8184-435e46ebb5cb"

data
SUCCESS · object
必填

任务数据(不同状态返回字段值不同)

Last modified on March 12, 2026