Growth Studio OpenAPI接入文档 · Images and System Avatars

上传图片

请求

POST /openapi/v1/image/upload
Content-Type: multipart/form-data
Authorization: Bearer <API_KEY>

表单字段:

字段 类型 必填 说明
image file 是 本地图片文件

图片要求:

cURL

curl --request POST \
  "${BASE_URL}/openapi/v1/image/upload" \
  --header "Authorization: Bearer ${API_KEY}" \
  --form 'image=@/absolute/path/product.webp'

成功响应

HTTP 状态码:200 OK

{
  "url": "https://media.pixverse.ai/marketing_hub_website/openapi_video_inputs/uploads/22/11/example.webp",
  "request_id": "upload-product-001"
}

url 是后续视频创建接口可以使用的内部 CDN URL。

查询系统模特

请求

GET /openapi/v1/avatars
Authorization: Bearer <API_KEY>