Canonical model endpoints

Use a model’s provider-independent URL in new integrations. Sunra selects the model’s default provider without requiring a provider selector:

POST https://api.sunra.ai/v1/queue/{owner}/{model}/{operation}

The following canonical models are available for GPT Image 2, Midjourney, and Kling:

Canonical model	Operations
`openai/gpt-image-2`	`text-to-image`, `image-editing`
`midjourney/v7`	`text-to-image`, `image-blending`, `face-swap`, `image-editing`, `action`, `describe`
`midjourney/v8.1`	`text-to-image`, `image-blending`, `face-swap`, `image-editing`, `action`, `describe`
`kling/kling-v3-4k`	`text-to-video`, `image-to-video`
`kling/kling-v3-omni-4k`	`text-to-video`, `image-to-video`, `reference-to-video`

For example:

curl -X POST "https://api.sunra.ai/v1/queue/openai/gpt-image-2/text-to-image" \
  -H "Authorization: Bearer $SUNRA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"prompt":"a cinematic sunrise over a quiet harbor","quality":"high"}'

Model names that contain preview remain canonical version names. Preview identifies a model version, not a provider.

Legacy compatibility

Provider-specific model URLs remain callable for existing integrations, but no longer appear in the public model catalog. Their URL, input schema, provider, pricing, and prediction identity are unchanged. New integrations should use the canonical model in the right-hand column.

Legacy model URL	Canonical model for new integrations
`openai/gpt-image-2-azure`	`openai/gpt-image-2`
`openai/gpt-image-2-reverse`	`openai/gpt-image-2`
`midjourney/v7-reverse`	`midjourney/v7`
`midjourney/v8.1-reverse`	`midjourney/v8.1`
`kling/kling-v3-4k-fal`	`kling/kling-v3-4k`
`kling/kling-v3-omni-4k-fal`	`kling/kling-v3-omni-4k`
`bytedance/seedance-2.0-relay`	`bytedance/seedance-2.0`
`bytedance/seedance-2.0-fast-relay`	`bytedance/seedance-2.0-fast`
`google/gemini-2.5-flash-image-preview-fal`	`google/gemini-2.5-flash-image`
`google/gemini-2.5-flash-image-preview-relay`	`google/gemini-2.5-flash-image`
`google/gemini-3-pro-image-preview-fal`	`google/gemini-3-pro-image-preview`
`google/gemini-3-pro-image-preview-relay`	`google/gemini-3-pro-image-preview`
`google/gemini-3.1-flash-image-preview-fal`	`google/gemini-3.1-flash-image-preview`
`google/gemini-3.1-flash-image-preview-relay`	`google/gemini-3.1-flash-image-preview`
`google/veo3-1-fal`	`google/veo3-1`
`google/veo3-1-fast-fal`	`google/veo3-1-fast`
`google/veo3-1-lite-fal`	`google/veo3-1-lite`

If a legacy endpoint exposes provider-specific capabilities, you may keep using that legacy URL. Compatibility does not redirect the request to the canonical model.

Overview

Platform

Multimodal

LLM

Client Libraries

Canonical Model Endpoints

Canonical model endpoints

Legacy compatibility

​Canonical model endpoints

​Legacy compatibility

Canonical model endpoints

Legacy compatibility