Models
In this page's examples, {BASE_URL} is https://api.uniall.ai.
The Models page is the normalized entry point for the selected UniAll model documentation. It groups pages by capability instead of preserving the original Apifox menu order.
Use the model-list endpoint when you need to discover the models available to the current API key at runtime.
Capability Categories
| Category | Pages | Typical endpoint |
|---|---|---|
| Image Generation | Async Image Generation, Seedream, Seedream 5.0 Pro, GPT-Image-2, GPT-Image-2.5, GPT-Image-2.6, Qwen Image, Nano Series (including Nano Banana 2.1), Kling | POST /v1/images/tasks, POST /v1/images/generations, or POST /v1/images/edits |
| Video Generation | Happy Horse, Seedance 2.0, Seedance 2.5, Grok Imagine, Veo 3.1, Gemini Omni Flash Preview, Vidu Q3, Hailuo, MiniMax H3 / H3 Max, Kling, Wan 2.6, Sora 2 | POST /v1/video/generations, POST /v1/videos, POST /v1beta/interactions, or POST /v2/video_generation |
| Audio and Music | Music Generation, Speech Synthesis | Model-specific audio endpoints |
| Digital Humans | Digital Human Video | Model-specific avatar video endpoint |
Model List Endpoint
GET /v1/models
The endpoint returns the current model list. UniAll can return compatibility-specific formats based on request headers:
| Request style | Detection rule | Response style |
|---|---|---|
| OpenAI compatible | Default request style | OpenAI model list |
| Anthropic compatible | Includes both x-api-key and anthropic-version | Anthropic-style model list |
| Gemini compatible | Includes x-goog-api-key header or key query parameter | Gemini-style model list |
For this documentation scope, the normalized pages focus on the selected image, video, audio, and digital-human capabilities.
Required Headers
Authorization: Bearer sk-***
Compatibility-specific clients may use their native authentication headers when documented by the client format.
Request Example
curl "{BASE_URL}/v1/models" \
-H "Authorization: Bearer sk-***"
Response Example
{
"object": "list",
"data": [
{
"id": "grok-imagine",
"object": "model",
"created": 0,
"owned_by": "uniall"
},
{
"id": "gpt-image-2.5-flare",
"object": "model",
"created": 0,
"owned_by": "uniall"
},
{
"id": "gpt-image-2.6-flare",
"object": "model",
"created": 0,
"owned_by": "uniall"
},
{
"id": "gpt-image-2.6-sunburst",
"object": "model",
"created": 0,
"owned_by": "uniall"
},
{
"id": "gpt-image-2",
"object": "model",
"created": 0,
"owned_by": "uniall"
}
]
}
Response Fields
| Field | Type | Description |
|---|---|---|
object | string | List object marker. |
data | array | Available model records. |
data[].id | string | Model ID to use in API requests. |
data[].object | string | Object type for the model record. |
data[].created | number | Creation timestamp if available. Some compatibility responses may use 0. |
data[].owned_by | string | Owner or provider label. |
Selection Guidance
-
For Nano Banana 2.1, use
nano-banana-2.1with the OpenAI Images guide, or the official IDgemini-nano-banana-2.1with the Gemini generateContent guide. Both formats return results synchronously. -
Use Async Image Generation when the task is image generation or image editing through a polling flow.
-
Use Qwen Image for synchronous generation and editing with the six 3.0, 2.1 and 2.0 models through OpenAI Images or the Bailian native API.
-
Use GPT-Image-2.5 for synchronous GPT Image 2.5 generation and editing.
-
Use GPT-Image-2.6 for synchronous generation, editing and GIF generation with
gpt-image-2.6-flareandgpt-image-2.6-sunburst. -
Use Seedream 5.0 Pro Image Generation when the model ID is
seedream-5.0-pro. -
Use Seedance 2.5 for
seedance2.5, including ordinary 1080p output and the 480p Draft to 1080p final-video workflow. -
Use the MiniMax H3 native API for
MiniMax-H3andMiniMax-H3-Maxvideo calls. -
Use Grok Imagine Video Generation when the model ID is
grok-imagine. -
Use Gemini Omni Flash Preview Video Generation when the model ID is
gemini-omni-flash-preview. -
Use Hailuo Video Generation when the model ID is
hailuo-02,hailuo-2.3, orhailuo-2.3-fast. -
Use Kling Image for
kling-v3,kling-v3-omni, orkling-image-o1image tasks. -
Use Kling Video for version-level Kling video models, and Digital Human Video for
operation: avatar. -
Use the capability-specific page for model-specific fields and task lifecycle details.
-
Treat
/v1/modelsas runtime discovery. Do not use it as the only source of integration rules.
Common Errors
| HTTP status | Meaning |
|---|---|
401 | Missing or invalid authentication. |
403 | The current API key is disabled or not allowed to access the model list. |