# 即梦 Free API 调用说明

本文档给人看，也给 AI 看。打开本页不需要登录。

- 网页：https://jimeng.red-packet.cn/docs
- Markdown：https://jimeng.red-packet.cn/docs.md
- AI 索引：https://jimeng.red-packet.cn/llms.txt
- JSON：https://jimeng.red-packet.cn/docs.json
- 接口根地址：https://jimeng.red-packet.cn

## 给 AI 的调用规则

用这套接口生成即梦图片和视频。

1. 根地址是 `https://jimeng.red-packet.cn`。
2. 生成类接口必须带 `Authorization: Bearer <token>`。
3. token 可以是管理后台创建的 `jm_` API Key，也可以是即梦官网 `sessionid`。
4. `POST /v1/chat/completions` 兼容 OpenAI。`model` 以 `jimeng-video` 开头则生成视频，否则生成图片。
5. 图片默认模型：`jimeng-image-5.0-lite`。视频默认模型：`jimeng-video-seedance-2.0-mini`。
6. 查模型列表：`GET /v1/models`（静态列表可不带鉴权）。
7. 健康检查：`GET /ping`，返回 `pong`。
8. 不要调用 `/dashboard` 或 `/account-pool`，那是管理员页面，不是生成接口。

## 鉴权

```http
Authorization: Bearer jm_your_api_key
Authorization: Bearer sessionid_value
Authorization: Bearer sessionid_1,sessionid_2
```

`jm_` Key 在管理后台 `https://jimeng.red-packet.cn/` 创建。直接使用即梦 sessionid 仍然可用。多个 sessionid 用英文逗号分隔时，服务会轮询。使用 `jm_` Key 时，服务会从账号池挑选已启用账号。

## 模型列表

标「仅 5秒」的视频模型会忽略 10 秒请求，强制 5 秒。

### 图片模型

| 模型 ID | 名称 | 类型 | 默认分辨率 | 支持分辨率 | 时长 |
|---|---|---|---|---|---|
| `jimeng-image-5.0-pro` | Seedream 5.0 Pro | 图片 | 2k | 4k, 2k, 1.5k | — |
| `jimeng-image-5.0-lite` | Seedream 5.0 Lite | 图片 | 2k | 4k, 2k | — |
| `jimeng-image-4.7` | Seedream 4.7 | 图片 | 2k | 4k, 2k | — |
| `jimeng-image-4.6` | Seedream 4.6 | 图片 | 2k | 4k, 2k | — |
| `jimeng-image-4.5` | Seedream 4.5 | 图片 | 2k | 4k, 2k | — |
| `jimeng-image-4.1` | Seedream 4.1 | 图片 | 2k | 4k, 2k | — |
| `jimeng-image-4.0` | Seedream 4.0 | 图片 | 2k | 4k, 2k | — |
| `jimeng-image-3.1` | Seedream 3.1 | 图片 | 1k | 1k | — |
| `jimeng-image-3.0` | Seedream 3.0 | 图片 | 1k | 1k | — |
| `jimeng-image-2.0-pro` | Seedream 2.0 Pro | 图片 | 1k | 1k | — |

### 视频模型

| 模型 ID | 名称 | 类型 | 默认分辨率 | 支持分辨率 | 时长 |
|---|---|---|---|---|---|
| `jimeng-video-seedance-2.5` | Seedance 2.5 | 视频 | 720p | 720p | 5秒 / 10秒 |
| `jimeng-video-seedance-2.0-mini` | Seedance 2.0 Mini | 视频 | 720p | 720p | 5秒 / 10秒 |
| `jimeng-video-seedance-2.0-fast` | Seedance 2.0 Fast VIP | 视频 | 720p | 720p | 5秒 / 10秒 |
| `jimeng-video-seedance-2.0-pro` | Seedance 2.0 VIP | 视频 | 720p | 720p, 1080p, 4k | 5秒 / 10秒 |
| `jimeng-video-seedance-1.5-pro` | Seedance 1.5 Pro | 视频 | 720p | 720p | 5秒 / 10秒 |
| `jimeng-video-3.0-pro` | Jimeng Video 3.0 Pro | 视频 | 1080p | 1080p | 5秒 / 10秒 |
| `jimeng-video-3.0` | Jimeng Video 3.0 | 视频 | 720p | 720p | 5秒 / 10秒 |
| `jimeng-video-3.0-fast` | Jimeng Video 3.0 Fast | 视频 | 720p | 720p, 1080p | 5秒 / 10秒 |
| `jimeng-video-s2.0` | Jimeng Video S2.0 | 视频 | 720p | 720p | 仅 5秒 |
| `jimeng-video-2.0-pro` | Jimeng Video 2.0 Pro | 视频 | 720p | 720p | 仅 5秒 |

`GET https://jimeng.red-packet.cn/v1/models` 返回同样的模型 ID，格式为 OpenAI 的 `{ data: [{ id, ... }] }`。可用查询参数 `?type=image` 或 `?type=video`。带 Authorization 时可能合并即梦官网最新模型；不带则返回上述内置列表。

## 提示词关键词

写在 `prompt` 或对话消息里会自动识别。

- 图片比例：21:9、16:9、3:2、4:3、1:1、3:4、2:3、9:16，以及 横屏 / 竖屏 / 方形
- 视频比例：16:9、9:16、1:1、4:3、3:4、21:9，以及 横屏 / 竖屏 / 方形
- 视频时长：`5秒`、`10秒`、`5s`、`10s`

如果 JSON 里显式传了 `ratio`、`resolution`、`duration`，以字段为准，优先于提示词检测。

## 接口

### GET /ping

免鉴权。响应正文：`pong`。

### GET /v1/models

鉴权可选。

```bash
curl -s https://jimeng.red-packet.cn/v1/models
curl -s "https://jimeng.red-packet.cn/v1/models?type=video"
```

### POST /v1/chat/completions

兼容 OpenAI Chat Completions。必填：`messages`。可选：`model`、`stream`。

图片示例：

```bash
curl -s https://jimeng.red-packet.cn/v1/chat/completions \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "jimeng-image-5.0-lite",
    "messages": [{"role": "user", "content": "一只赛博朋克柴犬，16:9"}]
  }'
```

视频示例：

```bash
curl -s https://jimeng.red-packet.cn/v1/chat/completions \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "jimeng-video-seedance-2.0-mini",
    "messages": [{"role": "user", "content": "海边日落延时，5秒，16:9"}]
  }'
```

多模态参考图（图片模型用第一张当参考图；视频模型用图片当首尾帧）：

```json
{
  "model": "jimeng-image-4.5",
  "messages": [{
    "role": "user",
    "content": [
      {"type": "text", "text": "把这张图改成水墨风格"},
      {"type": "image_url", "image_url": {"url": "https://example.com/ref.jpg"}}
    ]
  }]
}
```

`"stream": true` 会走 SSE。出图/出视频可能要几分钟，建议把读取超时设到 600 秒。

### POST /v1/images/generations

必填：`prompt`。可选：`model`、`ratio`、`resolution`、`negative_prompt`、`sample_strength`、`filePath`、`response_format`（`url` 或 `b64_json`）。

```bash
curl -s https://jimeng.red-packet.cn/v1/images/generations \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "jimeng-image-5.0-lite",
    "prompt": "一座未来城市，21:9",
    "ratio": "21:9",
    "resolution": "2k"
  }'
```

响应：

```json
{
  "created": 1710000000,
  "data": [{"url": "https://..."}]
}
```

### POST /v1/videos/generations

必填：`prompt`。可选：`model`、`ratio`、`resolution`、`duration`（5 或 10）、`file_paths`（首尾帧）、`response_format`。

```bash
curl -s https://jimeng.red-packet.cn/v1/videos/generations \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "jimeng-video-seedance-2.0-mini",
    "prompt": "镜头缓缓推进的森林，9:16",
    "ratio": "9:16",
    "duration": 5
  }'
```

### GET /v1/account/status

需要鉴权。返回当前账号积分等信息，不会返回 Cookie。

## 错误说明

失败时一般返回带 `code` 和 `message` 的 JSON。即梦积分不足时，服务可能自动降分辨率或缩短时长再试；仍不足才会报错。

管理后台（需要登录）：https://jimeng.red-packet.cn/