# 即梦模型接口

**请求统一接口：**
```shell
POST /jimeng/v1?Action=CVSync2AsyncSubmitTask&Version=2022-08-31
```

## 图片生成

### 文生图

**支持的模型**：jimeng_t2i_v30、jimeng_t2i_v31、jimeng_t2i_v40

**请求示例**

```shell [shell]
curl --location 'https://maas-openapi.wanjiedata.com/api/jimeng/v1?Action=CVSync2AsyncSubmitTask&Version=2022-08-31' \
--header 'Authorization: $API_KEY' \
--header 'Content-Type: application/json' \
--data '{
  "req_key": "$model",
  "prompt": "图片描述",
  "width": 1024, //可选，设置生成图片宽度
  "height": 1024 //可选，设置生成图片高度
}'
```

**响应示例**

```shell [shell]
{
    "code": 10000,
    "data": {
        "task_id": "6255328565324332385"
    },
    "message": "Success",
    "request_id": "20251218183633D2397D7031AA1E07E764",
    "status": 10000,
    "time_elapsed": "65.02005ms"
}
```

### 图生图

**支持的模型**：jimeng_i2i_v30、jimeng_t2i_v40

**请求示例**

```shell [shell]
curl --location 'https://maas-openapi.wanjiedata.com/api/jimeng/v1?Action=CVSync2AsyncSubmitTask&Version=2022-08-31' \
--header 'Authorization: $API_KEY' \
--header 'Content-Type: application/json' \
--data '{
  "req_key": "$model",
  "image_urls": [    
    "放入图片的 URL"
  ],
  /*
  image_urls 可选为通过 base64 方法传入：
  "binary_data_base64": [
    "这里放 base64 格式图片"
  ],
  */
  "prompt": "背景改成在黑洞边缘",
  "width": 1024,  //可选，设置生成图片宽度
  "height": 1024  //可选，设置生成图片高度
}'
```

**响应示例**
```shell [shell]
{
    "code": 10000,
    "data": {
        "task_id": "8575208137574726169"
    },
    "message": "Success",
    "request_id": "202512181839494EB07DA4F64E1F95AB35",
    "status": 10000,
    "time_elapsed": "306.295404ms"
}
```

## 视频生成

### 文生视频

**支持的模型**：jimeng_t2v_v30、jimeng_t2v_v30_1080p、jimeng_ti2v_v30_pro

**请求示例**

```shell [shell]
curl --location 'https://maas-openapi.wanjiedata.com/api/jimeng/v1?Action=CVSync2AsyncSubmitTask&Version=2022-08-31' \
--header 'Authorization: $API_Key' \
--header 'Content-Type: application/json' \
--data '{
  "req_key": "$model",
  "prompt": "输入生成指令"
}'
```

**响应示例**

```shell [shell]
{
    "code": 10000,
    "data": {
        "task_id": "4979419902357108017"
    },
    "message": "Success",
    "request_id": "2025121818472841343BB60CBCB206E467",
    "status": 10000,
    "time_elapsed": "83.921479ms"
}
```

### 图生视频

**设置首帧**

支持模型：jimeng_t2v_v30、jimeng_i2v_recamera_v30、jimeng_t2v_v30_1080p、jimeng_ti2v_v30_pro、jimeng_i2v_first_v30、jimeng_i2v_first_tail_v30、jimeng_i2v_first_tail_v30_1080

**请求示例**

```shell [shell]
curl --location 'https://maas-openapi.wanjiedata.com/api/jimeng/v1?Action=CVSync2AsyncSubmitTask&Version=2022-08-31' \
--header 'Authorization: $API_Key' \
--header 'Content-Type: application/json' \
--data '{
  "req_key": "",
  "image_urls": [
    "放入图片的 URL"
  ],
  /*
  image_urls 可选为通过 base64 方法传入：
  "binary_data_base64": [
    "这里放 base64 格式图片"
  ],
  */
  "prompt": "根据图片提供的内容，生成诙谐有趣的视频",
  "frames": 241  //可选，指定生成的总帧数，只能为241或121
}'
```

**响应示例**

```shell [shell]
{
    "code": 10000,
    "data": {
        "task_id": "1710861820765537194"
    },
    "message": "Success",
    "request_id": "20251218185149CC645B9239319D8D1C05",
    "status": 10000,
    "time_elapsed": "281.311523ms"
}
```

#### 设置首尾帧

**支持模型： jimeng_i2v_first_tail_v30、jimeng_i2v_first_tail_v30_1080**

**请求示例**
```shell [shell]
curl --location 'https://maas-openapi.wanjiedata.com/api/jimeng/v1?Action=CVSync2AsyncSubmitTask&Version=2022-08-31' \
--header 'Authorization: $API_Key' \
--header 'Content-Type: application/json' \
--data '{
  "req_key": "",
  "image_urls": [
    "放入图片的 URL",
    "放入图片的 URL"
  ],
  /*
  image_urls 可选为通过 base64 方法传入：
  "binary_data_base64": [
    "这里放 base64 格式图片",
    "这里放 base64 格式图片"
  ],
  */
  "prompt": "根据图片提供的内容，生成诙谐有趣的视频"
}'
```

**响应示例**

```shell [shell]
{
    "code": 10000,
    "data": {
        "task_id": "14557136066126270215"
    },
    "message": "Success",
    "request_id": "202512191628444CB9F31B2AE592D18716",
    "status": 10000,
    "time_elapsed": "1.329405288s"
}
```

#### 指定运镜模版及强度

**仅 jimeng_i2v_recamera_v30 支持**

**请求示例**
```shell [shell]
curl --location 'https://maas-openapi.wanjiedata.com/api/jimeng/v1?Action=CVSync2AsyncSubmitTask&Version=2022-08-31' \
--header 'Authorization: $API_Key' \
--header 'Content-Type: application/json' \
--data '{
  "req_key": "jimeng_i2v_recamera_v30",
  "image_urls": [
    "放入图片的 URL"
  ],
  /*
  image_urls 可选为通过 base64 方法传入：
  "binary_data_base64": [
    "这里放 base64 格式图片"
  ],
  */
  "prompt": "根据图片提供的内容，生成诙谐有趣的视频",
  "template_id": "dynamic_orbit",
  "camera_strength": "weak"
}'
```

**响应示例**

```shell [shell]
{
    "code": 10000,
    "data": {
        "task_id": "16466530988681469667"
    },
    "message": "Success",
    "request_id": "202512191628066F6C11A749953FFB89FD",
    "status": 10000,
    "time_elapsed": "361.102909ms"
}
```


## 查询任务

**查询统一接口**
```shell
POST /jimeng/v1?Action=CVSync2AsyncGetResult&Version=2022-08-31
```

通过上述请求得到的响应字段"task_id"对应的值，比如：1710861820765537194，进行查看生成内容

**请求示例**

```shell [shell]
curl --location 'https://maas-openapi.wanjiedata.com/api/jimeng/v1?Action=CVSync2AsyncGetResult&Version=2022-08-31' \
--header 'Authorization: $API_Key' \
--header 'Content-Type: application/json' \
--data '{
  "req_key": "输入请求时的模型",
  "task_id": "输入该请求后响应对应字段的值"
}'
```

**响应示例**

```shell [shell]
{
    "code": 10000,
    "data": {
        "aigc_meta_tagged": false,
        "status": "done",
        "video_url": "https://v3-vvecloud.yangyi08.com/8a31a704f1becead4eccb11ac2bc193d/6943ee3d/video/tos/cn/tos-cn-v-242bcc/oQCBQsRUBecBr5yUAAA1Nqf5KaAiD3ipgE9EAW/?a=7073&ch=0&cr=0&dr=0&er=0&lr=default&cd=0%7C0%7C0%7C0&br=3078&bt=3078&cs=0&ds=4&ft=xztlUQhhe6BMyqe2YTVJD12Nzj&mime_type=video_mp4&qs=13&rc=anRqbmw5cm93ODgzNGczM0BpanRqbmw5cm93ODgzNGczM0ByLV9wMmRjbS5hLS1kXi9zYSNyLV9wMmRjbS5hLS1kXi9zcw%3D%3D&btag=c0000e00008000&dy_q=1766055976&l=20251218190616A1C166390623BF0D4822"
    },
    "message": "Success",
    "request_id": "20251218190616A1C166390623BF0D4822",
    "status": 10000,
    "time_elapsed": "100.587365ms"
}
```

<mark>对于查看其它请求返回的具体内容时方法一致</mark>

<mark>万界方舟将持续为您更新模型接口文档，更多模型功能持续开发中，更多详细请求请访问[即梦官方文档](https://www.volcengine.com/docs/85621/1544716?lang=zh)</mark>