AibubuDevelopers
Developer Docs

Models

List the public OpenAI-compatible models currently available for external use.

This is one of the safest read-only endpoints to call first during integration.

GET /v1/models

Overview

ItemDescription
RouteGET /v1/models
AuthAuthorization: Bearer sk_aibubu_xxx
Request bodyNone
Response200 OK + model list

Typical use cases

  • Fetch the available model list at startup
  • Verify that a target model is enabled in the current environment
  • Build your own model selector in a dashboard or config UI

Authorizations

Authorization: Bearer sk_aibubu_your_api_key

Response

A successful response usually returns a model list object.

{
  "object": "list",
  "data": [
    {
      "id": "gpt-image-2",
      "name": "gpt-image-2",
      "region": "all",
      "family": "image",
      "description": "General image generation",
      "capabilities": ["image_generation"],
      "pricing": {"unit": "image", "display": "per image", "credits_text": "use /v1/quote"},
      "schema": {"fields": [{"name": "resolution", "type": "string", "required": false, "default": "1K", "options": ["1K", "2K", "4K"]}]},
      "ui_hints": [],
      "enabled": true
    }
  ]
}

Response fields

FieldTypeDescription
objectstringList object type, usually list
dataarrayCurrently available models
data[].idstringModel ID to pass in later requests
data[].familystringModel family: text, image, or video
data[].schema.fieldsarrayDynamic fields with names, types, required/default values, enum options, and limits
data[].pricingobjectDisplay metadata; use /v1/quote for accurate credits
data[].enabledbooleanWhether the model is currently enabled

Integration notes

  • Do not infer capabilities from model names; read family and schema.fields
  • There is no public /v1/models/{model}/schema; schema data is embedded in each list item
  • For parameter differences across models, see Supported Models and Parameters
  • For text models, also use schema.fields; do not assume fields such as reasoning or temperature are supported
  • If your frontend shows a dynamic model list, prefer refreshing it instead of hardcoding it

Current China-region public models

Public text models currently include GPT/GLM, Claude, Gemini, Grok, and DeepSeek families. Video models include the Seedance, Kling, and Gemini Omni families. Availability changes with live routes, region, and API-key permissions; use this endpoint as the source of truth.

On this page