sangtao.ai
API key

Nhân vật

Tải ảnh tham chiếu

Tải ảnh tham chiếu lên cho nhân vật: JPEG, PNG hoặc WEBP, tối đa 10 MB.

POSThttps://api.sangtao.ai/v2/characters/{id}/ref-images

Xác thực

  • X-Api-Keystring · headerbắt buộc

    API key của bạn, tạo ở trang API key trong tài khoản.

Tham số đường dẫn

  • idstringbắt buộc

    ID trong đường dẫn.

Gửi dạng multipart/form-data, file nằm ở trường file — ví dụ curl -F "[email protected]". Phần chạy thử không gửi được file, nên cột code chỉ hiện địa chỉ.

Body

  • filefile · multipart/form-databắt buộc

    Ảnh JPEG, PNG hoặc WEBP, tối đa 10 MB

Response

Ảnh vừa thêm: { id, imageUrl, thumbnailUrl, sortOrder } — như phần tử refImages[] ở Danh sách nhân vật. Tối đa 3 ảnh mỗi nhân vật.

Mã lỗi

MãerrorCodeKhi nào
400VALIDATION_ERRORKhông có file, không phải JPEG, PNG hoặc WEBP, quá 10 MB, hoặc nhân vật đã có 3 ảnh (ảnh thứ 4 bị từ chối)
404CHARACTER_NOT_FOUNDKhông có nhân vật này, hoặc không phải của bạn

Khi lỗi, success là false, errorCode như bảng trên, kèm error là câu mô tả.

POST/characters/{id}/ref-images
curl -X POST "https://api.sangtao.ai/v2/characters/ch_3kT9qPz0B/ref-images" \
  -H "X-Api-Key: YOUR_API_KEY"
{
  "success": true,
  "data": {
    "id": "ci_8hQ2mZr4K",
    "imageUrl": "https://…/a.png",
    "thumbnailUrl": "https://…/a_thumb.webp",
    "sortOrder": 0
  }
}