# gemini-omni-flash · API 接入

API 模型 ID 为 `gemini-omni-flash`。本文说明平台的实际契约，调用前请核对实时目录中的可用性。

## 历史平台请求示例（不代表当前官方可调用）

平台地址在构建时填入，运行前设置 API_KEY 为服务端密钥。

```bash
curl "https://newrouters.com/v1/tasks" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $API_KEY" \
  --data '{
  "model": "gemini-omni-flash",
  "input": {
    "seconds": 5,
    "resolution": "720p",
    "aspect_ratio": "16:9",
    "prompt": "A small red house in a quiet garden"
  }
}'
```

## 查询结果

创建响应表示任务已受理，不是最终结果。用返回的 ID 替换 TASK_ID，轮询至 succeeded 或 failed。

```bash
curl "https://newrouters.com/v1/tasks/TASK_ID" \
  -H "Authorization: Bearer $API_KEY"
```

成功查看 result，失败查看 error。上游结果未知时保留原任务 ID，不盲目重复提交付费生成。

## 参数说明

| 字段 | 类型 | 要求 | 默认值 | 限制 |
| --- | --- | --- | --- | --- |
| `images` | array | 可选 | — | 最多项数 20 |
| `prompt` | string | 必填 | — | 最大长度 100000 |
| `videos` | array | 可选 | — | 最多项数 1 |
| `seconds` | integer | 可选 | `5` | min 3; max 10 |
| `resolution` | enum | 可选 | `"720p"` | `720p` |
| `aspect_ratio` | enum | 可选 | `"16:9"` | `16:9`, `9:16` |








<!-- official-reference:start -->
## 官方来源与模型身份

核对日期: 2026-09-27 · 平台模型: `gemini-omni-flash` · 官方对应: `Gemini Omni Flash (legacy family)`

- [Gemini Omni Flash (legacy family) official reference](https://ai.google.dev/gemini-api/docs/models/gemini-omni-flash)
- [Google Omni generation API](https://ai.google.dev/gemini-api/docs/omni)
<!-- official-reference:end -->

## 计费与排错

接入时核对当前可用性、契约和账号价格。排错时保留请求 ID 与消费凭据。 [完整 API 参考](/zh/docs/api)

## 多语言请求示例

### JavaScript

```javascript
const apiBaseUrl = "https://newrouters.com";
const apiKey = process.env.API_KEY;
if (!apiKey) throw new Error("Set API_KEY in your server environment");

const response = await fetch(apiBaseUrl + "/v1/tasks", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer " + apiKey
  },
  body: JSON.stringify({
  "model": "gemini-omni-flash",
  "input": {
    "seconds": 5,
    "resolution": "720p",
    "aspect_ratio": "16:9",
    "prompt": "A small red house in a quiet garden"
  }
})
});

const result = await response.json();
if (!response.ok) throw new Error(JSON.stringify(result));
console.log(result);
```

### Python

```python
import json
import os
from urllib.request import Request, urlopen

api_base_url = "https://newrouters.com"
api_key = os.environ["API_KEY"]
body = json.loads("{\"model\":\"gemini-omni-flash\",\"input\":{\"seconds\":5,\"resolution\":\"720p\",\"aspect_ratio\":\"16:9\",\"prompt\":\"A small red house in a quiet garden\"}}")

request = Request(
    api_base_url + "/v1/tasks",
    data=json.dumps(body).encode("utf-8"),
    headers={
    "Content-Type": "application/json",
    "Authorization": "Bearer " + api_key
    },
    method="POST",
)
with urlopen(request) as response:
    print(json.load(response))
```

## 响应字段节选（示意值）

### HTTP 202

```json
{
  "id": "TASK_ID",
  "status": "pending",
  "model": "gemini-omni-flash",
  "result": null,
  "error": null
}
```

### HTTP 200

```json
{
  "id": "TASK_ID",
  "status": "succeeded",
  "model": "gemini-omni-flash",
  "result": {
    "assets": [
      "https://example.com/output.mp4"
    ]
  },
  "error": null
}
```