Tài khoản

Models

GEThttps://api.sangtao.ai/v2/models

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.

Danh sách model AI. Mỗi model có config object theo key định nghĩa form fields — render động thay vì hardcode. GET /models/{slug} trả một model, cùng khuôn, và nhận cả bí danh (GET /models/gpt-image-latest).

Tham số query

categorystring
Lọc theo category (mô tả ở bảng Danh mục Model bên dưới)
Giá trị có thể:image

Response

idnumber
Cũ — đừng dùng. Giữ cho code đang chạy; sẽ bỏ ở bản sau. Hãy dùng slug.
slugstringbắt buộc
ID duy nhất — dùng làm param model khi tạo, ví dụ "gpt-image-2.6"
displayNamestringbắt buộc
Tên hiển thị
categorystringbắt buộc
Category viết thường (xem bảng Danh mục Model bên dưới)
Giá trị có thể:image
creditCostnumberbắt buộc
Chi phí credit cơ bản mỗi lần tạo
descriptionstring
Mô tả model (nullable)
imageUrlstring
Ảnh preview model (nullable). Link ở đây và trong config (sampleOutputUrl…) đều ở cdn.sangtao.ai
aliasesstring[]
Các tên khác của model, gửi làm model cũng được — ví dụ ["gpt-image-latest"] với GPT Image. Danh sách có thể chứa thêm tên cũ của model; mọi tên trong danh sách đều gửi được. Đa số model để trống
serversobject[]
Các nơi model chạy được. Hiện mỗi model có một: "standard", là mặc định. Gửi id làm server khi tạo, hoặc bỏ trống để dùng mặc định
Hiện thuộc tính conẨn thuộc tính con
- idstring
  Mã server, gửi làm server.
- namestring
  Tên để hiển thị.
- descriptionstring | null
  Mô tả ngắn.
- defaultboolean
  true với server dùng khi bỏ trống server.
- creditCostnumber
  Chi phí credit cơ bản trên server này.
- availableboolean
  Hiện có nhận job không.
- capabilitiesobject
  Những gì server này làm được. Key nào không áp dụng thì không có.
  Hiện thuộc tính conẨn thuộc tính con
  resolutionsstring[]
  Các giá trị resolution nhận, ví dụ ["original", "1k", "2k"]. original giữ nguyên ảnh model trả về, không phóng to.
  defaultResolutionstring
  Dùng khi không gửi resolution: "original".
  aspectRatiosstring[]
  Các giá trị aspectRatio gợi ý.
  maxRefImagesnumber
  Số ảnh tham chiếu tối đa mỗi job.
  formatsstring[]
  Định dạng ảnh ra, cho format.
  transparentboolean
  Có yêu cầu nền trong suốt được không (requireTransparent).
configobject | null
Object config theo key — mỗi key là tên param, value là field definition (xem bên dưới)

Schema config field

Config là object theo key, mỗi key là tên tham số (ví dụ "aspectRatio", "imageResolution"). Key đặc biệt, không phải field: _badges (string[], badge hiển thị), maxRefImages (number, số ảnh tham chiếu tối đa).

typestringbắt buộc
Loại field
Giá trị có thể:selectcard-selectnumbertexttoggleupload
labelstringbắt buộc
Nhãn hiển thị (English)
labelVistring
Nhãn tiếng Việt
optionsobject[]
Options cho select/card-select [{value, label, imageUrl?}]
defaultany
Giá trị mặc định
minnumber
Giá trị tối thiểu (number)
maxnumber
Giá trị tối đa (number)
advancedboolean
Nếu true, hiển thị trong phần nâng cao
optionalboolean
Nếu true, field không bắt buộc

Model GPT Image (gpt-image-2.6, bí danh gpt-image-latest) có các key:

aspectRatioobject
Field select: "auto", "1:1", "16:9", "9:16"… Mặc định "auto"
imageResolutionobject
Field select, option "1k" (1K) và "2k" (2K). Mặc định "1k" — của khung chọn trên web. Gọi API thì trường là resolution, bỏ trống nghĩa là "original" (xem GPT Image)
maxRefImagesnumber
Một số, không phải field: số ảnh tham chiếu model nhận. GPT Image là 20

Khi gửi job tạo nội dung, đưa giá trị config vào params cùng cấp với prompt và model.

Danh mục Model

Category	Mô tả
image	Tạo ảnh AI (GPT Image)

Danh sách có thể có thêm các công cụ video cũ (video, voiceovervideo, stockvideo, slideshowvideo, articlevideo, render). Các công cụ này đang chuyển sang Motion và không có tài liệu.

Mã lỗi

Mã	errorCode	Khi nào
404	MODEL_NOT_FOUND	GET /models/{slug}: không có model với slug này, hoặc model thuộc nhóm API không cung cấp

GET/models

curl "https://api.sangtao.ai/v2/models?category=image" \
  -H "X-Api-Key: YOUR_API_KEY"

{
  "success": true,
  "data": [
    {
      "id": 48,
      "slug": "gpt-image-2.6",
      "displayName": "GPT Image 2.6",
      "category": "image",
      "description": null,
      "imageUrl": null,
      "creditCost": 3,
      "config": {
        "maxRefImages": 20,
        "aspectRatio": {
          "type": "select",
          "label": "Aspect Ratio",
          "labelVi": "Tỉ lệ khung hình",
          "options": [
            {
              "value": "auto",
              "label": "Auto"
            },
            {
              "value": "1:1",
              "label": "1:1"
            },
            {
              "value": "9:16",
              "label": "9:16"
            },
            {
              "value": "16:9",
              "label": "16:9"
            }
          ],
          "default": "auto"
        },
        "imageResolution": {
          "type": "select",
          "label": "Resolution",
          "labelVi": "Độ phân giải",
          "options": [
            {
              "value": "1k",
              "label": "1K"
            },
            {
              "value": "2k",
              "label": "2K"
            }
          ],
          "default": "1k"
        }
      },
      "aliases": [
        "gpt-image-latest"
      ],
      "servers": [
        {
          "id": "standard",
          "name": "Standard",
          "description": null,
          "default": true,
          "creditCost": 3,
          "available": true,
          "capabilities": {
            "resolutions": [
              "original",
              "1k",
              "2k"
            ],
            "defaultResolution": "original",
            "aspectRatios": [
              "auto",
              "1:1",
              "9:16",
              "16:9"
            ],
            "maxRefImages": 20,
            "formats": [
              "png",
              "jpeg"
            ],
            "transparent": true
          }
        }
      ]
    }
  ]
}

GET/models

curl "https://api.sangtao.ai/v2/models?category=image" \
  -H "X-Api-Key: YOUR_API_KEY"

{
  "success": true,
  "data": [
    {
      "id": 48,
      "slug": "gpt-image-2.6",
      "displayName": "GPT Image 2.6",
      "category": "image",
      "description": null,
      "imageUrl": null,
      "creditCost": 3,
      "config": {
        "maxRefImages": 20,
        "aspectRatio": {
          "type": "select",
          "label": "Aspect Ratio",
          "labelVi": "Tỉ lệ khung hình",
          "options": [
            {
              "value": "auto",
              "label": "Auto"
            },
            {
              "value": "1:1",
              "label": "1:1"
            },
            {
              "value": "9:16",
              "label": "9:16"
            },
            {
              "value": "16:9",
              "label": "16:9"
            }
          ],
          "default": "auto"
        },
        "imageResolution": {
          "type": "select",
          "label": "Resolution",
          "labelVi": "Độ phân giải",
          "options": [
            {
              "value": "1k",
              "label": "1K"
            },
            {
              "value": "2k",
              "label": "2K"
            }
          ],
          "default": "1k"
        }
      },
      "aliases": [
        "gpt-image-latest"
      ],
      "servers": [
        {
          "id": "standard",
          "name": "Standard",
          "description": null,
          "default": true,
          "creditCost": 3,
          "available": true,
          "capabilities": {
            "resolutions": [
              "original",
              "1k",
              "2k"
            ],
            "defaultResolution": "original",
            "aspectRatios": [
              "auto",
              "1:1",
              "9:16",
              "16:9"
            ],
            "maxRefImages": 20,
            "formats": [
              "png",
              "jpeg"
            ],
            "transparent": true
          }
        }
      ]
    }
  ]
}

Trang trướcLịch sử giao dịch Trang sauGPT Image