sangtao.ai
API key

Nhân vật

Lấy một nhân vật

Lấy một nhân vật của bạn.

GEThttps://api.sangtao.ai/v2/characters/{id}

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.

Response

Một Character — các trường xem ở Danh sách nhân vật.

Mã lỗi

MãerrorCodeKhi nào
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ả.

GET/characters/{id}
curl "https://api.sangtao.ai/v2/characters/ch_3kT9qPz0B" \
  -H "X-Api-Key: YOUR_API_KEY"
{
  "success": true,
  "data": {
    "id": "ch_3kT9qPz0B",
    "name": "Mèo Mướp",
    "appearanceDescription": "orange tabby cat, chubby body, half-closed drowsy eyes, white belly patch",
    "biography": "Chú mèo lười của tiệm sách, hay ngủ trên quầy thu ngân.",
    "aliases": "Mướp, Bé Mướp",
    "publishStatus": null,
    "createdAt": "2026-11-08T09:12:44Z",
    "updatedAt": "2026-11-08T09:20:01Z",
    "refImages": [
      {
        "id": "ci_8hQ2mZr4K",
        "imageUrl": "https://…/a.png",
        "thumbnailUrl": "https://…/a_thumb.webp",
        "sortOrder": 0
      }
    ]
  }
}