Oatda list models

OATDA List Models

List all available AI models from OATDA's providers with optional filtering.

API Key Resolution

All commands need the OATDA API key. Resolve it inline for each exec call:

export OATDA_API_KEY="${OATDA_API_KEY:-$(cat ~/.oatda/credentials.json 2>/dev/null | jq -r '.profiles[.defaultProfile].apiKey' 2>/dev/null)}"

If the key is empty or null, tell the user to get one at https://oatda.com and configure it.

Security: Never print the full API key. Only verify existence or show first 8 chars.

API Calls

All requests are GET. Add query parameters to filter.

List all models

export OATDA_API_KEY="${OATDA_API_KEY:-$(cat ~/.oatda/credentials.json 2>/dev/null | jq -r '.profiles[.defaultProfile].apiKey' 2>/dev/null)}" && \
curl -s -X GET "https://oatda.com/api/v1/llm/models" \
  -H "Authorization: Bearer $OATDA_API_KEY"

Filter by type

• ?type=chat — Text/chat models
• ?type=image — Image generation models
• ?type=video — Video generation models
• ?type=audio — Speech, transcription, and translation models

Filter by provider

• ?provider=openai
• ?provider=anthropic
• ?provider=google
• ?provider=bytedance
• ?provider=deepseek
• etc.

Combine filters

curl -s -X GET "https://oatda.com/api/v1/llm/models?type=image&provider=openai" \
  -H "Authorization: Bearer $OATDA_API_KEY"

Discover model-specific parameters

Image, video, and audio models include supported_params describing model-specific options:

# Image model params
curl -s -X GET "https://oatda.com/api/v1/llm/models?type=image" \
  -H "Authorization: Bearer $OATDA_API_KEY" | jq '.image_models[] | {id, supported_params}'

# Video model params
curl -s -X GET "https://oatda.com/api/v1/llm/models?type=video" \
  -H "Authorization: Bearer $OATDA_API_KEY" | jq '.video_models[] | {id, supported_params}'

# Specific provider's video params
curl -s -X GET "https://oatda.com/api/v1/llm/models?type=video&provider=bytedance" \
  -H "Authorization: Bearer $OATDA_API_KEY" | jq '.video_models[] | select(.model | contains("seedance")) | .supported_params'

# Audio model params
curl -s -X GET "https://oatda.com/api/v1/llm/models?type=audio" \
  -H "Authorization: Bearer $OATDA_API_KEY" | jq '.audio_models[] | {id, supported_params}'

Response Format

{
  "total": 42,
  "filter": {"type": "all", "provider": null},
  "chatModels": [
    {"id": "provider/model-name", "provider": "...", "model": "...", "displayName": "..."}
  ],
  "imageModels": [
    {
      "id": "provider/model-name",
      "provider": "...",
      "model": "...",
      "displayName": "...",
      "supported_params": {
        "style": {"type": "string", "values": ["vivid", "natural"], "default": "vivid"}
      }
    }
  ],
  "videoModels": [
    {
      "id": "provider/model-name",
      "provider": "...",
      "model": "...",
      "displayName": "...",
      "supported_params": {
        "ratio": {"type": "string", "values": ["16:9", "9:16", "1:1"], "default": "16:9"},
        "duration": {"type": "string", "values": ["5", "10"], "default": "5"},
        "generate_audio": {"type": "boolean", "default": false, "optional": true},
        "first_frame_image": {"type": "file", "accept": "image/*", "optional": true}
      }
    }
  ],
  "audio_models": [
    {
      "id": "provider/model-name",
      "provider": "...",
      "model_name": "...",
      "display_name": "...",
      "supported_params": {
        "audio_modes": ["tts", "transcription", "translation"],
        "voice": {"type": "string", "values": ["alloy", "nova", "shimmer"]},
        "response_format": {"type": "string", "values": ["mp3", "wav", "json", "srt", "vtt"]}
      }
    }
  ]
}

Understanding supported_params

Each parameter has:

• type: string, number, boolean, or file
• values: Allowed values for enums
• default: Default value
• description: What it does
• optional: Whether required
• accept: For file types — accepted MIME types (e.g., "image/*")
• min / max: Range constraints for numbers

File-type params (e.g., mask, first_frame_image, last_frame_image) require public HTTPS URLs, not local paths.

Audio modes: Audio models may support one or more modes such as tts, transcription, and translation. Use that to choose the right workflow:

• tts → oatda-generate-speech
• transcription → oatda-transcribe-audio
• translation → oatda-translate-audio

Presenting Results

Format models by category. Use the actual data returned by the API — do not hardcode model names.

Chat Models (N total):

• provider/model-name — Display Name

Image Models (N total):

• provider/model-name — Display Name

Video Models (N total):

• provider/model-name — Display Name

Audio Models (N total):

• provider/model-name — Display Name

Error Handling

HTTP Status	Meaning	Action
401	Invalid API key	Tell user to check their key
429	Rate limited	Wait and retry

Notes

• This is a GET request — no request body
• The id field (e.g., openai/gpt-4o) is the model identifier used in other OATDA skills
• Use supported_params to discover model-specific parameters before generating
• For file-type params, provide publicly accessible URLs
• Audio models may expose audio_modes, supported voices, and output formats
• Related skills: oatda-text-completion, oatda-generate-image, oatda-generate-video, oatda-generate-speech, oatda-transcribe-audio, oatda-translate-audio, oatda-vision-analysis