sangtao.ai
API key

Nhân vật

Thêm ảnh từ link

Thêm ảnh tham chiếu cho nhân vật từ một link công khai.

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

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.

Body

  • imageUrlstringbắt buộc

    Link http/https công khai tới ảnh JPEG, PNG hoặc WEBP, tối đa 10 MB. Ảnh được tải về và lưu bản sao

Response

Ảnh vừa thêm: { id, imageUrl, thumbnailUrl, sortOrder }. thumbnailUrl ban đầu là null, vài giây sau mới có.

Mã lỗi

MãerrorCodeKhi nào
400VALIDATION_ERRORThiếu imageUrl, link không phải http/https, là file của tài khoản khác, không phải JPEG, PNG hoặc WEBP, hoặc nhân vật đã có 3 ảnh
400REFERENCE_IMAGE_UNREACHABLEKhông tải được ảnh từ link (error ghi lý do). Ở đây là 400; GPT Image trả cùng mã này với 422
400UPLOAD_FAILEDĐã tải được ảnh nhưng không lưu được — thử lạ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/from-url
curl -X POST "https://api.sangtao.ai/v2/characters/ch_3kT9qPz0B/ref-images/from-url" \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "imageUrl": "https://example.com/meo.png"
  }'
{
  "success": true,
  "data": {
    "id": "ci_8hQ2mZr4K",
    "imageUrl": "https://…/a.png",
    "thumbnailUrl": null,
    "sortOrder": 0
  }
}