---
title: "Get an AI model schema"
method: GET
path: "/ai/models/{modelId}"
tags: ["AI"]
---

# Get an AI model schema

`GET /ai/models/{modelId}`

## Request

- Base URL: `https://api.rendley.com/v1`
- URL: `https://api.rendley.com/v1/ai/models/{modelId}`
- Auth: API key in header `Authorization`

Return one model and the JSON Schema accepted in the params object by that model's generation and cost endpoints. This schema is generated from the runtime validator and is the source of truth for dynamic forms and integrations.

## Path parameters

- `modelId` string, required

## Response `200`

OK

- object
  - `data` object: Success data
    - `action` 'transcribe' | 'generate_image' | 'generate_video' | 'generate_video_avatar' | 'text_to_speech' | 'voice_isolation' | 'remove_video_background' | 'remove_image_background' | 'video_translate' | 'generate_text' | 'voice_changer' | 'generate_music' | 'generate_sound_effect' | 'upscale_image' | 'upscale_video' | 'lipsync' | 'smart_cut'
    - `description` string
    - `id` 'grok-imagine-image-2' | 'minimax-h3' | 'kling-v3-omni-video' | 'dalle-3' | 'whisper' | 'gpt-4o-mini-tts' | 'veo-3.1' | 'veo-3.1-fast' | 'heygen' | 'nano-banana' | 'nano-banana-pro' | 'gpt-image-2' | 'eleven-labs-tts' | 'eleven-labs-voice-isolation' | 'eleven-labs-voice-changer' | 'eleven-labs-speech-to-text' | 'remove-video-background' | 'remove-image-background' | 'kling-v2.6' | 'kling-v2.6-motion-control' | 'kling-v2.5-turbo-pro' | 'seedance-1.5-pro' | 'seedance-2.0' | 'seedance-2.0-fast' | 'seedance-2.5' | 'grok-imagine-r2v' | 'grok-imagine-video' | 'grok-imagine-video-extension' | 'grok-imagine-video-1.5' | 'p-video' | 'wan-2.7-t2v' | 'wan-2.7-i2v' | 'hailuo-2.3' | 'imagen-4' | 'seedream-4' | 'flux-1.1-pro' | 'lipsync' | 'video-translate' | 'gemini-2.5-flash' | 'lyria-3-pro' | 'eleven-labs-music' | 'eleven-labs-sound-effect' | 'upscale-image' | 'video-upscaler' | 'flux-video-upscale' | 'wan-3-prime' | 'flux-2-pro' | 'eleven-labs-dubbing' | 'seedream-5-lite' | 'wan-3' | 'gemini-omni-1.1' | 'kling-v3-video' | 'gpt-image-2.5-sunburst' | 'gpt-image-2.5-flare' | 'flux-2-flex' | 'ltx-2.5-fast' | 'pixverse-v6' | 'qwen-image-3-pro' | 'flux-2-max' | 'qwen-image-3' | 'z-image-turbo' | 'flux-3' | 'omni-human-1.5' | 'seedream-4.5' | 'seedance-2.0-mini' | 'seedream-5-pro'
    - `name` string
    - `params_schema` object
    - `schema_url` string, uri-reference
    - `tagline` string
  - `error` HttpResponseAPIError
    - `code` string
    - `fields` HttpResponseFieldError[]
      - `field` string
      - `message` string
    - `message` string
  - `meta` unknown

## Other responses

- `401`: Unauthorized
- `404`: Not Found

---

[API](https://skmtc.dev/rendley/apis/rendley-api.md) - [All operations](https://skmtc.dev/rendley/apis/rendley-api/llms.txt) - [OpenAPI document](https://skmtc.dev/rendley/apis/rendley-api/revisions/7eb8713bbf78?raw)