Describe（图像描述）

通过 Describe 接口提交图像描述任务。请求成功后，Vortap 会返回任务 ID 与当前任务状态，可用于后续查询任务结果。

接口地址

POST https://www.vortapapi.com/v1/ideogram/describe

请求头

名称	必填	说明
Content-Type	是	请求体类型。通常使用 application/json 或接口要求的内容类型。
Accept	是	响应内容类型。建议设置为 application/json。
Authorization	是	API Key 认证信息，格式通常为 Bearer sk-***。

响应示例

{
  "code": 0,
  "message": "SUCCEED",
  "request_id": "CjMT7WdSwWcAAAAAALvB3g",
  "data": {
    "task_id": "CjMT7WdSwWcAAAAAALvB3g",
    "task_status": "submitted",
    "created_at": 1733851336696,
    "updated_at": 1733851336696
  }
}

响应字段说明

字段	类型	说明
code	integer	请求处理结果码。0 表示提交成功。
message	string	请求结果信息。
request_id	string	本次请求的唯一标识。
data	object	任务信息。
data.task_id	string	已创建的任务 ID。
data.task_status	string	当前任务状态，例如 submitted 表示任务已提交。
data.created_at	integer	任务创建时间，Unix 毫秒时间戳。
data.updated_at	integer	任务最近更新时间，Unix 毫秒时间戳。