Skip to main content
GET
/
api
/
partner
/
v1
/
studio
/
models
Get Studio Models
curl --request GET \
  --url https://api.example.com/api/partner/v1/studio/models
{
  "ok": true,
  "code": 200,
  "message": "Studio models retrieved",
  "data": {
    "mode": "image",
    "total": 1,
    "models": [
      {
        "id": "google/nano-banana",
        "mode": "image",
        "name": "Nano Banana",
        "provider": "Google",
        "credits": {
          "default_cost": 1,
          "notes": "Credits match in-app AI Studio cost calculation."
        }
      }
    ]
  }
}
Returns partner-ready model metadata for Studio generation.

​
Query Parameters

​
mode
string
Optional filter: image, video, or all. Omit to return both (all).

​
Response

Successful requests return 200 with:
  • mode - all, image, or video
  • total - number of returned models
  • models - normalized model list

​
Model Object

FieldTypeDescription
idstringModel ID used in generation requests
modeimage | videoModel category
namestringDisplay name
providerstringProvider label
descriptionstringShort model description
credits.default_costnumberDefault credit estimate
credits.notesstringCredit calculation notes
capabilitiesobjectSupported input/output modes
inputsobjectRequired and optional fields, plus conditional rules (for example one_of:motion,prompt or one_of:audio_url,speech_text) when applicable
paramsobjectNormalized params and options
raw_available_paramsobject | nullRaw internal options for advanced mapping
inputs.optional only lists speech_text, voice_id, and audio_url when the selected model supports explicit speech, lipsync input, or Seedance 2.0 reference audio. Prompt-driven models such as openai/sora-2 and google/veo-3 are prompt-only: include spoken dialogue inside prompt and do not send separate speech fields. 
{
  "ok": true,
  "code": 200,
  "message": "Studio models retrieved",
  "data": {
    "mode": "image",
    "total": 1,
    "models": [
      {
        "id": "google/nano-banana",
        "mode": "image",
        "name": "Nano Banana",
        "provider": "Google",
        "credits": {
          "default_cost": 1,
          "notes": "Credits match in-app AI Studio cost calculation."
        }
      }
    ]
  }
}

​
Error Responses

  • 401 - authentication failed (missing/invalid/revoked token)
  • 402 subscription_required - active Creator/Professional/Business plan required
  • 403 tier_not_allowed - Scheduler tier cannot use Partner API
  • 422 invalid_query - unsupported mode