Account
Models
https://api.sangtao.ai/v2/modelsAuthorization
X-Api-Keystring · headerrequiredYour API key, from the API keys page of your account.
List available AI models. Each model includes a keyed config object that defines form fields — render these dynamically instead of hardcoding. GET /models/{slug} returns one model, in the same shape, and takes an alias too (GET /models/gpt-image-latest).
Query parameters
categorystringFilter by category (described under Model categories below)
Available options:
image
Response
idnumberLegacy — do not use. Kept for existing code; it goes away in a later version. Use slug.
slugstringrequiredUnique model identifier — use as the model param when creating, e.g. "gpt-image-2.6"
displayNamestringrequiredDisplay name
categorystringrequiredLowercase category (see Model categories below)
Available options:
imagecreditCostnumberrequiredBase credit cost per generation
descriptionstringModel description (nullable)
imageUrlstringModel preview image (nullable). Links here and in config (sampleOutputUrl…) are on cdn.sangtao.ai
aliasesstring[]Other names the model answers to, also accepted as model — e.g. ["gpt-image-latest"] for GPT Image. It may also hold the model’s former names; every name in the list can be sent. Empty for most models
serversobject[]Where the model can run. Every model has one for now: "standard", the default. Pass id as server when creating, or leave server out for the default
Show child attributesHide child attributes
idstringThe server, to send as server.
namestringIts name to show.
descriptionstring | nullA short description.
defaultbooleantrue for the one used when server is left out.
creditCostnumberBase credit cost on this server.
availablebooleanWhether it takes jobs now.
capabilitiesobjectWhat this server can do. A key is there only when it applies.
Show child attributesHide child attributes
resolutionsstring[]Values resolution takes, e.g. ["original", "1k", "2k"]. original keeps the image as the model made it, no upscaling.
defaultResolutionstringUsed when resolution is left out: "original".
aspectRatiosstring[]Suggested aspectRatio values.
maxRefImagesnumberMost reference images per job.
formatsstring[]Output formats, for format.
transparentbooleanWhether a transparent background can be asked for (requireTransparent).
configobject | nullKeyed config object — each key is a param name, value is field definition (see below)
Config field schema
Config is a keyed object where each key is the parameter name (e.g. "aspectRatio", "imageResolution"). Special keys, not fields: _badges (string[], display badges), maxRefImages (number, max reference images).
typestringrequiredField type
Available options:
selectcard-selectnumbertexttoggleuploadlabelstringrequiredDisplay label (English)
labelVistringVietnamese label
optionsobject[]Options for select/card-select [{value, label, imageUrl?}]
defaultanyDefault value
minnumberMin value (number fields)
maxnumberMax value (number fields)
advancedbooleanIf true, show in advanced/collapsed section
optionalbooleanIf true, field is optional
The GPT Image model (gpt-image-2.6, alias gpt-image-latest) has these keys:
aspectRatioobjectA select field: "auto", "1:1", "16:9", "9:16"… Default "auto"
imageResolutionobjectA select field with options "1k" (1K) and "2k" (2K). Default "1k" — the web picker's. Over the API the field is resolution, and leaving it out means "original" (see GPT Image)
maxRefImagesnumberA plain number, not a field: how many reference images the model takes. 20 for GPT Image
Model categories
| Category | Description |
|---|---|
| image | AI image generation (GPT Image) |
The list may also hold the older video tools (video, voiceovervideo, stockvideo, slideshowvideo, articlevideo, render). They are moving to Motion and are not documented.
Errors
| Status | errorCode | When |
|---|---|---|
| 404 | MODEL_NOT_FOUND | GET /models/{slug}: no model with this slug, or one in a category the API does not offer |
/modelscurl "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
}
}
]
}
]
}/modelscurl "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
}
}
]
}
]
}