众扬汇 AI 开放平台 API 文档

提交生成视频任务-异步

接口:POST /luma/generations_sync 归属:视频模型/Luma/官方接口格式 调用地址:Base URL https://api.allyang.cn(OpenAI 兼容前缀 https://api.allyang.cn/v1)+ 上述路径 鉴权:请求头 Authorization: Bearer <你的令牌>;令牌在控制台「令牌管理」创建 说明:下方为本接口契约。路径、字段名与枚举取值与线上接口一致;叙述文字已按本平台口径重写。价格、并发与限流等数值以控制台及实际返回为准,未确认处标注「待补」。

OpenAPI Specification

yaml
openapi: 3.0.1
info:
  title: ''
  description: ''
  version: 1.0.0
paths:
  /luma/generations_sync:
    post:
      summary: 提交生成视频任务-异步
      description: "提交更快,适合上传图片等响应较慢的场景,可避免客户端超时;代价是失败时系统无法自动重试,失败率会略高。"
      tags:
        - 视频模型/Luma/官方接口格式
      parameters:
        - name: Authorization
          in: header
          description: ''
          required: false
          example: Bearer {{YOUR_API_KEY}}
          schema:
            type: string
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                user_prompt:
                  type: string
                aspect_ratio:
                  type: string
                expand_prompt:
                  type: boolean
                  description: "是否开启 prompt 优化。"
                image_url:
                  type: string
                  description: "参考图,支持外部图片地址或 Base64 编码。"
                image_end_url:
                  type: string
                  description: "关键帧,支持外部图片地址或 Base64 编码。"
                notify_hook:
                  type: string
                  description: "回调地址:<示例回调地址待补>。"
              required:
                - user_prompt
            examples: {}
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties: {}
              example:
                id: 9d4b7516-77e5-481a-b015-48313946f33b
                prompt: cat dance
                state: pending
                created_at: '2024-07-01T07:35:13.498660Z'
                video: null
                liked: null
                estimate_wait_seconds: null
          headers: {}
      security: []
components:
  schemas: {}
  securitySchemes: {}
servers: []
security: []