> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sunra.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Canonical 模型端点

> 使用稳定、无 provider 后缀的生图和生视频模型 URL，同时保持旧 provider-specific URL 兼容。

# Canonical 模型端点

新集成应使用模型不带 provider 后缀的 canonical URL。Sunra 会选择模型的默认 provider，不需要暴露 provider selector：

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

GPT Image 2、Midjourney 和 Kling 新增以下 canonical 模型：

| Canonical 模型             | 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`                            |

例如：

```bash theme={null}
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":"电影感的日出照亮安静港湾","quality":"high"}'
```

模型名中的 `preview` 会继续保留；`Preview` 是模型版本标识，不是 provider。

## Legacy Compatibility

旧 provider-specific 模型 URL 仍可供现有集成直接调用，但不再出现在公开模型目录中。旧 URL、输入 schema、provider、pricing 和 prediction identity 均保持不变。新集成请使用右侧 canonical 模型。

| 旧模型 URL                                       | 新集成使用的 Canonical 模型                     |
| --------------------------------------------- | --------------------------------------- |
| `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`                    |

如果旧端点提供了 provider-specific 额外能力，可以继续使用该旧 URL。兼容调用不会被重定向到 canonical 模型。