runninghub-api

https://www.runninghub.cn/runninghub-api-doc-cn
Admin
runninghub-api is an API for managing and interacting with various AI tasks, offering...
Tokens:844,307
Snippets:1,887
Trust Score:7.4
Update:2 months ago
Show doc for...
Tokens:
Raw
### POST /openapi/v2/minimax/hailuo-02/pro

Source: https://www.runninghub.cn/runninghub-api-doc-cn/api-448183135

调用海螺-02-pro 模型进行视频生成。该模型支持原生 1080p 超清输出，具备增强的运动与物理引擎，支持纯文本驱动或图像引导生成。

```APIDOC
## POST /openapi/v2/minimax/hailuo-02/pro

### Description
MiniMax 视频生成体系中的专业级旗舰模型，专为追求极致视觉品质与物理真实的创作者打造。支持原生 1080p 超清输出，具备增强的运动与物理引擎。

### Method
POST

### Endpoint
/openapi/v2/minimax/hailuo-02/pro

### Parameters
#### Header Parameters
- **Authorization** (string) - Required - Bearer [Your API KEY]

#### Request Body
- **prompt** (string) - Required - 提示词，最大长度 2000
- **enablePromptExpansion** (boolean) - Required - 是否启用提示词扩展
- **duration** (string) - Required - 视频时长，可选值: '6'
- **firstImageUrl** (string) - Optional - 首帧图像 URL (JPG, PNG)
- **lastImageUrl** (string) - Optional - 尾帧图像 URL (JPG, PNG)

### Request Example
{
  "prompt": "一名中世纪骑士的重型钢锤击中一面水晶盾牌...",
  "enablePromptExpansion": true,
  "duration": "6"
}

### Response
#### Success Response (200)
- **taskId** (string) - 任务 ID，用于后续查询任务结果
- **status** (string) - 任务状态 (QUEUED, RUNNING, SUCCESS, FAILED)
- **errorCode** (string) - 错误码
- **errorMessage** (string) - 错误信息
- **results** (array) - 任务输出结果列表

#### Response Example
{
  "taskId": "task_12345",
  "status": "QUEUED"
}
```

--------------------------------

### Request Body Example for Get Account Information

Source: https://www.runninghub.cn/runninghub-api-doc-cn/api-425748943

This is an example of the JSON request body required to call the Get Account Information API. It includes the API key.

```json
{
  "apikey": "{{apiKey}}"
}
```

--------------------------------

### Response Example for Get Account Information

Source: https://www.runninghub.cn/runninghub-api-doc-cn/api-425748943

This is an example of a successful JSON response from the Get Account Information API. It includes the account status details like RH coins, task counts, and wallet balance.

```json
{
  "code": 0,
  "msg": "success",
  "data": {
    "remainCoins": "99999",
    "currentTaskCounts": "0",
    "remainMoney": "999",
    "currency": "CNY",
    "apiType": "NORMAL"
  }
}
```

--------------------------------

### POST /openapi/v2/minimax/hailuo-02/i2v-pro

Source: https://www.runninghub.cn/runninghub-api-doc-cn/api-448183079

将静态图像转换为极具沉浸感的专业影像片段，支持电影级光影与运动仿真。

```APIDOC
## POST /openapi/v2/minimax/hailuo-02/i2v-pro

### Description
Hailuo 02 (I2V Pro) 是 AI 视频生成领域的突破性之作，专为追求电影级写实感与物理精确性的创作者打造。该模型支持原生 1080P 全高清输出，通过 5 秒时长的灵活创作机制与智能镜头转场技术，将静态图像转化为专业影像片段。

### Method
POST

### Endpoint
/openapi/v2/minimax/hailuo-02/i2v-pro

### Parameters
#### Header Parameters
- **Content-Type** (string) - Optional - application/json
- **Authorization** (string) - Required - Bearer [Your API KEY]

#### Request Body
- **prompt** (string) - Optional - 描述视频生成内容的提示词，最大长度 2000 字符。
- **enablePromptExpansion** (boolean) - Required - 是否启用提示词扩展。
- **firstImageUrl** (string) - Required - 起始图像的 URL，支持 JPG, PNG 格式。
- **lastImageUrl** (string) - Optional - 结束图像的 URL，支持 JPG, PNG 格式。

### Request Example
{
  "prompt": "专业电影级序列。基于原图，发光的宇宙粒子开始围绕人物手部以真实的流体动力学旋动。",
  "enablePromptExpansion": true,
  "firstImageUrl": "https://www.runninghub.cn/view?filename=example.jpg"
}

### Response
#### Success Response (200)
- **taskId** (string) - 任务 ID，用于后续查询任务结果。
- **status** (string) - 任务状态 (QUEUED, RUNNING, SUCCESS, FAILED)。
- **errorCode** (string) - 错误码。
- **errorMessage** (string) - 错误信息。
- **results** (array) - 生成结果列表。
```

--------------------------------

### GET /ai-application/example

Source: https://www.runninghub.cn/runninghub-api-doc-cn/api-494858278

Retrieve an example of an AI application API call.

```APIDOC
## GET /ai-application/example

### Description
Retrieve an example of how to call the AI application API.

### Method
GET

### Endpoint
/ai-application/example
```

--------------------------------

### POST /openapi/v2/minimax/hailuo-2.3/image-to-video-pro

Source: https://www.runninghub.cn/runninghub-api-doc-cn/api-448183078

调用海螺 2.3 Pro 模型将静态图像转化为 1080p 全高清视频，支持运动渲染与物理模拟。

```APIDOC
## POST /openapi/v2/minimax/hailuo-2.3/image-to-video-pro

### Description
Hailuo 2.3 Pro 是 MiniMax 视频生成技术的旗舰之作，专为追求极致视觉品质的创作者与专业工作室打造。该模型能将静态图像转化为原生 1080p 全高清电影级视频。

### Method
POST

### Endpoint
/openapi/v2/minimax/hailuo-2.3/image-to-video-pro

### Parameters
#### Header Parameters
- **Authorization** (string) - Required - Bearer [Your API KEY]
- **Content-Type** (string) - Optional - application/json

#### Request Body
- **prompt** (string) - Optional - 提示词，描述视频内容，最大长度 2000。
- **enablePromptExpansion** (boolean) - Required - 是否启用提示词扩展。
- **imageUrl** (string) - Required - 输入图片的 URL，支持 JPG, PNG 格式。

### Request Example
{
  "prompt": "专业电影级追踪镜头。角色身披的丝绸斗篷随着真实的物理风力自然摆动。",
  "enablePromptExpansion": true,
  "imageUrl": "https://www.runninghub.cn/view?filename=example.jpg"
}

### Response
#### Success Response (200)
- **taskId** (string) - 任务 ID，用于后续查询任务结果。
- **status** (string) - 任务状态 (QUEUED, RUNNING, SUCCESS, FAILED)。
- **errorCode** (string) - 错误码。
- **errorMessage** (string) - 错误信息。
- **results** (array) - 包含输出文件 URL、类型及文本内容的数组。

#### Response Example
{
  "taskId": "task_12345",
  "status": "QUEUED",
  "results": []
}
```

--------------------------------

### Get LoRA Upload URL Request Example

Source: https://www.runninghub.cn/runninghub-api-doc-cn/api-425749009

This is an example of the request body to obtain the LoRA upload URL. Ensure you provide the correct apiKey, loraName, and md5Hex.

```json
{
  "apiKey": "{{apiKey}}",
  "loraName": "my-lora-name",
  "md5Hex": "f8d958506e6c8044f79ccd7c814c6179"
}
```

--------------------------------

### POST /openapi/v2/minimax/music-cover-preprocess

Source: https://www.runninghub.cn/runninghub-api-doc-cn/api-494858303

对参考音频进行预处理，提取音频特征和歌词，用于两步翻唱流程。

```APIDOC
## POST /openapi/v2/minimax/music-cover-preprocess

### Description
对参考音频进行预处理，提取音频特征和歌词，用于两步翻唱流程。

### Method
POST

### Endpoint
/openapi/v2/minimax/music-cover-preprocess

### Parameters
#### Request Body
- **audioUrl** (string) - Required - 参考音频，6 秒至 6 分钟。支持的文件格式：MP3, WAV, FLAC.

### Request Example
{
  "audioUrl": "https://example.com/input.mp3"
}

### Response
#### Success Response (200)
- **taskId** (string) - 任务 ID，用于后续查询任务结果。
- **status** (string) - 任务状态 (QUEUED, RUNNING, SUCCESS, FAILED)。
- **errorCode** (string) - 错误码。
- **errorMessage** (string) - 错误信息。
- **results** (array) - 任务输出结果列表。
- **clientId** (string) - 客户端标识。
- **promptTips** (string) - 提示词执行反馈。

#### Response Example
{
  "taskId": "task_123",
  "status": "SUCCESS",
  "errorCode": "0",
  "errorMessage": "",
  "results": [],
  "clientId": "client_001",
  "promptTips": "{}"
}
```

--------------------------------

### 可灵文生视频o3-4k OpenAPI 定义

Source: https://www.runninghub.cn/runninghub-api-doc-cn/api-449426881

定义了文生视频接口的请求参数、响应结构及认证方式。使用 POST 请求调用 /openapi/v2/kling-video-o3-4k/text-to-video 路径。

```yaml
openapi: 3.0.1
info:
  title: ''
  description: ''
  version: 1.0.0
paths:
  /openapi/v2/kling-video-o3-4k/text-to-video:
    post:
      summary: 可灵文生视频o3-4k
      deprecated: false
      description: >-
        可灵 O3 4K 文生视频是快手最新一代 4K 文生视频模型，融合物理感知运动、高时序一致性与原生音频生成能力。支持 3-15
        秒灵活时长、16:9/9:16/1:1 多画幅，可选同步音频。相比 V3.0
        系列在物理拟真度和语义理解上有显著提升，适合复杂动作场景、剧情叙事和品牌叙事级视频创作。
      operationId: postOpenapiV2KlingVideoO34kTextToVideo
      tags:
        - 模型API/视频生成与处理/text-to-video/可灵文生视频o3
        - 标准模型API/视频生成与处理/text-to-video/可灵文生视频o3
      parameters:
        - name: Content-Type
          in: header
          description: ''
          required: false
          example: application/json
          schema:
            type: string
            default: application/json
        - name: Authorization
          in: header
          description: ''
          required: true
          example: Bearer [Your API KEY]
          schema:
            type: string
            default: Bearer [Your API KEY]
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                prompt:
                  type: string
                  minLength: 1
                  maxLength: 2500
                  default: >-
                    午后办公室，一位疲惫的上班族拿起一杯热气腾腾的现磨咖啡。他用鼻子深吸香气，眼神从疲惫转为明亮。时间仿佛暂停，镜头围绕咖啡杯旋转，背景从凌乱工位变成清晨的咖啡种植园。最后画面回到现实，他微笑轻啜，字幕浮现：“唤醒灵感”。风格：干净、明亮、微距特写。
                  description: 视频画面、动作、镜头、氛围的文字描述
                aspectRatio:
                  type: string
                  enum:
                    - '16:9'
                    - '9:16'
                    - '1:1'
                  default: '16:9'
                  description: 视频宽高比
                  x-option-metadata:
                    - value: '16:9'
                      description: '16:9'
                    - value: '9:16'
                      description: '9:16'
                    - value: '1:1'
                      description: '1:1'
                duration:
                  type: integer
                  minimum: 3
                  maximum: 15
                  multipleOf: 1
                  default: 5
                  description: 视频时长（秒，3-15）
                sound:
                  type: boolean
                  default: false
                  description: 是否同时生成同步音频
                shotType:
                  type: string
                  enum:
                    - customize
                    - intelligence
                  default: customize
                  description: 分镜方式，当 multiShot 参数为true时，当前参数必填
                  x-option-metadata:
                    - value: customize
                      description: customize
                    - value: intelligence
                      description: intelligence
                multiPrompt:
                  type: array
                  items:
                    type: string
                  maxItems: 6
                  default: []
                  description: 多分镜 prompt 列表（可选）
                elementList:
                  type: array
                  items:
                    type: string
                  maxItems: 3
                  default: []
                  description: 元素引用列表（可选）
                multiShot:
                  type: boolean
                  default: false
                  description: >-
                    是否生成多镜头视频（为true时，prompt参数无效，为false时，shotType参数及multiPrompt参数无效）
              required:
                - prompt
                - duration
              x-apifox-orders:
                - prompt
                - aspectRatio
                - duration
                - sound
                - shotType
                - multiPrompt
                - elementList
                - multiShot
            example:
              prompt: >-
                午后办公室，一位疲惫的上班族拿起一杯热气腾腾的现磨咖啡。他用鼻子深吸香气，眼神从疲惫转为明亮。时间仿佛暂停，镜头围绕咖啡杯旋转，背景从凌乱工位变成清晨的咖啡种植园。最后画面回到现实，他微笑轻啜，字幕浮现：“唤醒灵感”。风格：干净、明亮、微距特写。
              aspectRatio: '16:9'
              duration: 5
              sound: false
              shotType: customize
              multiShot: false
      responses:
        '200':
          x-apifox-name: 成功
          x-apifox-ordering: 0
          description: <Icon icon="material-outline-info"/> 任务结果查询接口：`/openapi/v2/query`
          content:
            application/json:
              schema:
                type: object
                properties:
                  taskId:
                    type: string
                    description: 任务 ID，用于后续查询任务结果。
                  status:
                    type: string
                    enum:
                      - QUEUED
                      - RUNNING
                      - SUCCESS
                      - FAILED
                    description: 任务状态。
                  errorCode:
                    type: string
                    description: 错误码。
                  errorMessage:

```

--------------------------------

### POST /openapi/v2/vidu/start-end-to-video-q3-turbo

Source: https://www.runninghub.cn/runninghub-api-doc-cn/api-448183067

Generates a video by interpolating between a provided start frame and end frame, guided by a text prompt.

```APIDOC
## POST /openapi/v2/vidu/start-end-to-video-q3-turbo

### Description
This endpoint generates a 16-second video by interpolating between a start image and an end image. It is designed for efficient production, allowing for precise control over motion paths and cinematic quality.

### Method
POST

### Endpoint
/openapi/v2/vidu/start-end-to-video-q3-turbo

### Parameters
#### Header Parameters
- **Authorization** (string) - Required - Bearer [Your API KEY]
- **Content-Type** (string) - Optional - application/json

#### Request Body
- **prompt** (string) - Required - Descriptive text for the video generation (1-4000 characters).
- **firstImageUrl** (string) - Required - URL of the starting image (JPG, PNG).
- **lastImageUrl** (string) - Required - URL of the ending image (JPG, PNG).
- **duration** (string) - Optional - Video duration in seconds (1-16).
- **resolution** (string) - Optional - Video resolution (540p, 720p, 1080p).
```

--------------------------------

### Example of retainSeconds Usage

Source: https://www.runninghub.cn/runninghub-api-doc-cn/api-425749013

Demonstrates the usage of the `retainSeconds` parameter, which is applicable for enterprise shared API keys to reduce cold start times by reusing instances.

```json
"retainSeconds": 60
```

--------------------------------

### POST /openapi/v2/minimax/music-2.6/text-to-music

Source: https://www.runninghub.cn/runninghub-api-doc-cn/api-471297131

调用 MiniMax Music 2.6 模型，根据提供的文本描述和歌词生成高质量音乐作品。

```APIDOC
## POST /openapi/v2/minimax/music-2.6/text-to-music

### Description
MiniMax Music 2.6 是一款专业的 AI 音乐生成模型，支持通过文本描述和歌词创作完整歌曲。模型理解风格、情绪、场景等多维描述，能够生成旋律流畅、人声自然的高质量音乐作品。

### Method
POST

### Endpoint
/openapi/v2/minimax/music-2.6/text-to-music

### Parameters
#### Header Parameters
- **Authorization** (string) - Required - Bearer [Your API KEY]
- **Content-Type** (string) - Optional - application/json

#### Request Body
- **prompt** (string) - Optional - 音乐描述，用于指定风格、情绪和场景。
- **lyrics** (string) - Required - 歌曲歌词，支持结构标签：[Intro], [Verse], [Chorus], [Bridge], [Outro]等。
- **sampleRate** (string) - Optional - 采样率，可选值：16000, 24000, 32000, 44100。
- **bitrate** (string) - Optional - 比特率，可选值：32000, 64000, 128000, 256000。
- **format** (string) - Optional - 音频格式，可选值：mp3, wav, pcm。
- **lyricsOptimizer** (boolean) - Optional - 是否根据描述自动优化歌词。

### Request Example
{
  "prompt": "描述个人面对成长后的平静，励志，娓娓道来的感觉",
  "lyrics": "[Verse] 心早有预感...",
  "sampleRate": "44100"
}
```

--------------------------------

### Get AI Application API Call Demo

Source: https://www.runninghub.cn/runninghub-api-doc-cn/api-425749011

This endpoint provides a demo for making AI application API requests. You can use this example to quickly initiate API calls.

```APIDOC
## GET /api/webapp/apiCallDemo

### Description
Provides a demo for AI application API requests, allowing users to quickly initiate API calls by referencing the example.

### Method
GET

### Endpoint
/api/webapp/apiCallDemo

### Parameters
#### Query Parameters
- **apiKey** (string) - Required - 
- **webappId** (string) - Required - 

#### Header Parameters
- **Authorization** (string) - Required - Example: Bearer [Your API KEY]

### Response
#### Success Response (200)
- **code** (integer) - 
- **msg** (string) - 
- **data** (object) - 
  - **curl** (string) - 
  - **webappName** (string) - AI应用名称
  - **statisticsInfo** (object) - 统计信息
    - **likeCount** (string) - 
    - **downloadCount** (string) - 
    - **useCount** (string) - 
    - **pv** (string) - 
    - **collectCount** (string) - 
  - **nodeInfoList** (array) - 节点信息列表
    - **nodeId** (string) - 
    - **nodeName** (string) - 
    - **fieldName** (string) - 
    - **fieldValue** (string) - 
    - **fieldData** (string) - 
    - **fieldType** (string) - 
    - **description** (string) - 
    - **descriptionEn** (string) - 
  - **covers** (array) - 
    - **id** (string) - 
    - **objName** (string) - 
    - **url** (string) - 
    - **thumbnailUri** (string) - 
    - **imageWidth** (string) - 
    - **imageHeight** (string) - 
```

--------------------------------

### POST /openapi/v2/minimax/hailuo-h3/text-to-video

Source: https://www.runninghub.cn/runninghub-api-doc-cn/api-495380674

MiniMax-H3（Hailuo-03）文生视频，2K 直出，5-15 秒时长，多宽高比可选。

```APIDOC
## POST /openapi/v2/minimax/hailuo-h3/text-to-video

### Description
MiniMax-H3（Hailuo-03）文生视频，2K 直出，5-15 秒时长，多宽高比可选。

### Method
POST

### Endpoint
/openapi/v2/minimax/hailuo-h3/text-to-video

### Parameters
#### Header Parameters
- **Authorization** (string) - Required - Bearer [Your API KEY]

#### Request Body
- **prompt** (string) - Required - 视频生成提示词 (1-20480 字符)
- **resolution** (string) - Required - 输出分辨率 (2K, 768P)
- **duration** (string) - Required - 视频时长（秒），范围 5-15
- **ratio** (string) - Optional - 宽高比 (21:9, 16:9, 4:3, 1:1, 3:4, 9:16)
- **aigc_watermark** (boolean) - Optional - 是否在生成视频中添加 AIGC 水印

### Request Example
{
  "prompt": "冰川上骑着一匹马。",
  "resolution": "2K",
  "duration": "5",
  "ratio": "16:9",
  "aigc_watermark": false
}

### Response
#### Success Response (200)
- **taskId** (string) - 任务 ID，用于后续查询任务结果
- **status** (string) - 任务状态 (QUEUED, RUNNING, SUCCESS)

#### Response Example
{
  "taskId": "task_id_example",
  "status": "QUEUED"
}
```

--------------------------------

### POST /openapi/v2/alibaba/wan-2.6/text-to-video

Source: https://www.runninghub.cn/runninghub-api-doc-cn/api-448183155

提交文生视频生成任务。该接口支持角色扮演与多镜头叙事，输出 1080P/24fps 高清视频。

```APIDOC
## POST /openapi/v2/alibaba/wan-2.6/text-to-video

### Description
通义万相 2.6 是阿里巴巴通义实验室推出的专业级 AI 视频生成模型，支持角色扮演与多镜头叙事。用户输入文本即可生成连贯叙事视频。

### Method
POST

### Endpoint
/openapi/v2/alibaba/wan-2.6/text-to-video

### Parameters
#### Header Parameters
- **Authorization** (string) - Required - Bearer [Your API KEY]
- **Content-Type** (string) - Optional - application/json

#### Request Body
- **prompt** (string) - Required - 视频生成提示词 (5-5000字符)
- **negativePrompt** (string) - Optional - 负面提示词
- **duration** (string) - Required - 视频时长，可选: '5', '10', '15'
- **resolution** (string) - Required - 分辨率，可选: 1280*720, 720*1280, 1920*1080, 1080*1920
- **shotType** (string) - Required - 镜头类型，可选: single, multi

### Request Example
{
  "prompt": "一只小巧可爱的卡通小猫将军，身穿细节精致的金色盔甲，头戴一个稍大的头盔，勇敢地站在悬崖上",
  "duration": "5",
  "resolution": "1080*1920",
  "shotType": "single"
}

### Response
#### Success Response (200)
- **taskId** (string) - 任务 ID，用于后续查询任务结果
- **status** (string) - 任务状态 (QUEUED, RUNNING, SUCCESS, FAILED)
- **errorCode** (string) - 错误码
- **errorMessage** (string) - 错误信息
- **results** (array) - 结果列表

#### Response Example
{
  "taskId": "task_12345",
  "status": "QUEUED"
}
```

--------------------------------

### OpenAPI Specification for API Key List

Source: https://www.runninghub.cn/runninghub-api-doc-cn/api-432924538

This OpenAPI 3.0.1 specification defines the GET endpoint for querying API keys. It includes request headers, response structure, and example data.

```yaml
openapi: 3.0.1
info:
  title: ''
  description: ''
  version: 1.0.0
paths:
  /openapi/v2/api-key/list:
    get:
      summary: 查询 APIKEY 列表
      deprecated: false
      description: ''
      tags:
        - 账户相关
      parameters:
        - name: Authorization
          in: header
          description: ''
          required: true
          example: Bearer [Your API KEY]
          schema:
            type: string
            default: Bearer [Your API KEY]
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties:
                  code:
                    type: integer
                  msg:
                    type: string
                  errorMessages:
                    type: 'null'
                  data:
                    type: array
                    items:
                      type: object
                      properties:
                        key:
                          type: string
                          title: apikey
                        apiKeyName:
                          type: 'null'
                          title: 名称
                        status:
                          type: integer
                          title: 状态
                        quotaLimit:
                          type: 'null'
                          title: 限额
                        quotaUsed:
                          type: integer
                          title: 已用额度
                        visible:
                          type: boolean
                        expireAt:
                          type: 'null'
                        expireInMinute:
                          type: 'null'
                        createdAt:
                          type: string
                      required:
                        - key
                        - apiKeyName
                        - status
                        - quotaLimit
                        - quotaUsed
                        - visible
                        - expireAt
                        - expireInMinute
                        - createdAt
                      x-apifox-orders:
                        - key
                        - apiKeyName
                        - status
                        - quotaLimit
                        - quotaUsed
                        - visible
                        - expireAt
                        - expireInMinute
                        - createdAt
                required:
                  - code
                  - msg
                  - errorMessages
                  - data
                x-apifox-orders:
                  - code
                  - msg
                  - errorMessages
                  - data
              example:
                code: 0
                msg: success
                errorMessages: null
                data:
                  - key: 46eb********06340
                    apiKeyName: null
                    status: 1
                    quotaLimit: null
                    quotaUsed: 10
                    visible: false
                    expireAt: null
                    expireInMinute: null
                    createdAt: '2026-03-24T13:26:45.000+00:00'
                  - key: c800df1*******7df3de9
                    apiKeyName: null
                    status: 1
                    quotaLimit: null
                    quotaUsed: 138.54
                    visible: true
                    expireAt: null
                    expireInMinute: null
                    createdAt: '2026-01-19T08:07:14.000+00:00'
          headers: {}
          x-apifox-name: 成功
      security: []
      x-apifox-folder: 账户相关
      x-apifox-status: developing
      x-run-in-apifox: https://app.apifox.com/web/project/7913447/apis/api-432924538-run
components:
  schemas: {}
  securitySchemes: {}
servers:
  - url: https://www.runninghub.cn
    description: runninghub.cn
security: []

```

--------------------------------

### 万相2.5 Preview 文生视频 OpenAPI 规范

Source: https://www.runninghub.cn/runninghub-api-doc-cn/api-448183160

定义了文生视频接口的请求路径、头部参数及请求体结构，包括 prompt、duration 和 size 等核心配置项。

```yaml
openapi: 3.0.1
info:
  title: ''
  description: ''
  version: 1.0.0
paths:
  /openapi/v2/alibaba/wan-2.5-preview/text-to-video:
    post:
      summary: 万相2.5 Preview 文生视频
      deprecated: false
      description: >-
        万相2.5 Preview
        文生视频是阿里通义万相系列的视频生成模型。支持通过文本描述生成高质量视频，提供5或10秒可控时长与多种画幅比例，支持音频驱动生成和智能提示词改写，适用于短视频创作与内容创意制作。
      operationId: postOpenapiV2AlibabaWan25PreviewTextToVideo
      tags:
        - 模型API/视频生成与处理/text-to-video/万相2.5 Preview 文生视频
        - 标准模型API/视频生成与处理/text-to-video/万相2.5 Preview 文生视频
      parameters:
        - name: Content-Type
          in: header
          description: ''
          required: false
          example: application/json
          schema:
            type: string
            default: application/json
        - name: Authorization
          in: header
          description: ''
          required: true
          example: Bearer [Your API KEY]
          schema:
            type: string
            default: Bearer [Your API KEY]
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                prompt:
                  type: string
                  minLength: 1
                  maxLength: 1500
                  default: 镜头跟随黑衣男子快速逃亡,后面一群人在追,镜头转为侧面跟拍,人物惊慌撞倒路边的水果摊爬起来继续逃,人群慌乱的声音
                  description: prompt
                negativePrompt:
                  type: string
                  minLength: 0
                  maxLength: 500
                  description: negativePrompt
                audioUrl:
                  type: string
                  format: uri
                  description: >-
                    音频文件URL，模型将使用该音频生成视频。时长：3～30s。文件大小：不超过15MB。超限处理：若音频长度超过
                    duration 值（
                    如5秒），自动截取前5秒，其余部分丢弃。若音频长度不足视频时长，超出音频长度部分为无声视频。例如，音频为3秒，视频时长为5秒，输出视频前3秒有声，后2秒无声。


                    支持的文件格式：MP3, WAV.
                duration:
                  type: string
                  enum:
                    - '5'
                    - '10'
                  default: '5'
                  description: duration
                  x-option-metadata:
                    - value: '5'
                      description: '5'
                    - value: '10'
                      description: '10'
                size:
                  type: string
                  enum:
                    - 832*480
                    - 480*832
                    - 624*624
                    - 1280*720
                    - 720*1280
                    - 960*960
                    - 1088*832
                    - 832*1088
                    - 1920*1080
                    - 1080*1920
                    - 1440*1440
                    - 1632*1248
                    - 1248*1632
                  default: 1920*1080
                  description: 指定生成的视频分辨率，格式为宽*高
                  x-option-metadata:
                    - value: 832*480
                      description: 832*480 (16:9)
                    - value: 480*832
                      description: 480*832 (9:16)
                    - value: 624*624
                      description: 624*624 (1:1)
                    - value: 1280*720
                      description: 1280*720 (16:9)
                    - value: 720*1280
                      description: 720*1280 (9:16)
                    - value: 960*960
                      description: 960*960 (1:1)
                    - value: 1088*832
                      description: 1088*832 (4:3)
                    - value: 832*1088
                      description: 832*1088 (3:4)
                    - value: 1920*1080
                      description: 1920*1080 (16:9)
                    - value: 1080*1920
                      description: 1080*1920 (9:16)
                    - value: 1440*1440
                      description: 1440*1440 (1:1)
                    - value: 1632*1248
                      description: 1632*1248 (4:3)
                    - value: 1248*1632
                      description: 1248*1632 (3:4)
                promptExtend:
                  type: boolean
                  default: true
                  description: |-
                    是否开启prompt智能改写

                    checked=开启 / unchecked=关闭
                seed:
                  type: integer
                  minimum: 0
                  maximum: 2147483647
                  multipleOf: 1
                  description: 随机数种子
              required:
                - prompt
                - duration
                - size
              x-apifox-orders:
                - prompt
                - negativePrompt
                - audioUrl
                - duration
                - size
                - promptExtend
                - seed
            example:
              prompt: 镜头跟随黑衣男子快速逃亡,后面一群人在追,镜头转为侧面跟拍,人物惊慌撞倒路边的水果摊爬起来继续逃,人群慌乱的声音
              duration: '5'
              size: 1920*1080
```

--------------------------------

### Get Webhook Event Details OpenAPI Specification

Source: https://www.runninghub.cn/runninghub-api-doc-cn/api-425749005

This OpenAPI 3.0.1 specification defines the endpoint for retrieving webhook event details. It includes request parameters, headers, and response structures, along with examples.

```yaml
openapi: 3.0.1
info:
  title: ''
  description: ''
  version: 1.0.0
paths:
  /task/openapi/getWebhookDetail:
    post:
      summary: 获取webhook事件详情
      deprecated: false
      description: 此接口旨在帮助调试用户的webhook，通过taskId查询到当前webhook事件的详细状态，拿到事件的id后可以发起重试
      tags:
        - 任务和查询 & webhook
      parameters:
        - name: Host
          in: header
          description: ''
          required: true
          example: www.runninghub.cn
          schema:
            type: string
        - name: Authorization
          in: header
          description: ''
          required: true
          example: Bearer [Your API KEY]
          schema:
            type: string
            default: Bearer [Your API KEY]
      requestBody:
        content:
          application/json:
            schema:
              $ref: >-
                #/components/schemas/%E8%8E%B7%E5%8F%96webhook%E4%BA%8B%E4%BB%B6%E8%AF%A6%E6%83%85Request
              description: ''
            example:
              apiKey: '{{apiKey}}'
              taskId: '1904154698679771137'
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/R%3F'
              example:
                code: 0
                msg: success
                data:
                  id: '1904444422778503169'
                  userApiKey: '******************'
                  taskId: '1904444422770114561'
                  webhookUrl: https://your-webhook-url
                  eventData: >-
                    {"code":0,"msg":"success","data":[{"fileUrl":"https://rh-images.xiaoyaoyou.com/de0db6f2564c8697b07df55a77f07be9/output/ComfyUI_00059_hnona_1742889987.png","fileType":"png","taskCostTime":78,"nodeId":"9"}]}
                  callbackStatus: FAILED
                  callbackResponse: >-
                    I/O error on POST request for "https://your-webhook-url":
                    Remote host terminated the handshake
                  retryCount: 3
                  createTime: '2025-03-25T16:05:07'
                  updateTime: '2025-03-25T16:08:10'
          headers: {}
          x-apifox-name: 成功
      security: []
      x-apifox-folder: 任务和查询 & webhook
      x-apifox-status: released
      x-run-in-apifox: https://app.apifox.com/web/project/7913447/apis/api-425749005-run
components:
  schemas:
    获取webhook事件详情Request:
      type: object
      properties:
        apiKey:
          type: string
          description: ''
          examples:
            - '{{apiKey}}'
        taskId:
          type: string
          examples:
            - '1904154698679771137'
      x-apifox-orders:
        - apiKey
        - taskId
      x-apifox-ignore-properties: []
      x-apifox-folder: ''
    R?:
      type: object
      properties:
        code:
          type: integer
          description: 返回标记：成功标记=0，非0失败，或者是功能码
        msg:
          type: string
          description: 返回信息
        data:
          description: 数据
          type: 'null'
      x-apifox-orders:
        - code
        - msg
        - data
      x-apifox-ignore-properties: []
      x-apifox-folder: ''
  securitySchemes: {}
servers:
  - url: https://www.runninghub.cn
    description: runninghub.cn
security: []

```
Tokens:
Raw