跳转到正文

查询任务

OpenAPI Specification

yaml
openapi: 3.0.1
info:
  title: ''
  description: ''
  version: 1.0.0
paths:
  /v1/videos/video_id:
    get:
      summary: '查询任务 '
      deprecated: false
      description: |+
        给定一个提示,该模型将返回一个或多个预测的完成,并且还可以返回每个位置的替代标记的概率。

        为提供的提示和参数创建完成

      tags:
        - 视频模型/sora 视频生成/统一视频格式
      parameters:
        - name: id
          in: query
          description: |
            任务ID
          required: true
          example: sora-2:task_01kbfq03gpe0wr9ge11z09xqrj
          schema:
            type: string
        - name: Content-Type
          in: header
          description: ''
          required: true
          example: application/json
          schema:
            type: string
        - name: Accept
          in: header
          description: ''
          required: true
          example: application/json
          schema:
            type: string
        - name: Authorization
          in: header
          description: ''
          required: false
          example: Bearer {{YOUR_API_KEY}}
          schema:
            type: string
        - name: X-Forwarded-Host
          in: header
          description: ''
          required: false
          example: localhost:5173
          schema:
            type: string
      requestBody:
        content:
          multipart/form-data:
            schema:
              type: object
              properties: {}
            examples: {}
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties:
                  id:
                    type: string
                  status:
                    type: string
                  video_url:
                    type: 'null'
                  enhanced_prompt:
                    type: string
                  status_update_time:
                    type: integer
                required:
                  - id
                  - status
                  - video_url
                  - enhanced_prompt
                  - status_update_time
                x-apifox-orders:
                  - id
                  - status
                  - video_url
                  - enhanced_prompt
                  - status_update_time
              examples:
                '1':
                  summary: pending
                  value:
                    id: sora-2:task_01k6x15vhrff09dkkqjrzwhm60
                    detail:
                      id: task_01k6x15vhrff09dkkqjrzwhm60
                      input:
                        size: small
                        model: sy_ore
                        images:
                          - >-
                            https://example.com/?sample-input-image=1
                          - >-
                            https://example.com/?sample-input-image=2
                        prompt: make animate
                        orientation: portrait
                      status: pending
                      pending_info:
                        id: task_01k6x15vhrff09dkkqjrzwhm60
                        seed: null
                        type: video_gen
                        user: user-a1sGDUIOXV32hNITe59LEkHa
                        model: sy_8
                        title: New Video
                        width: 352
                        height: 640
                        prompt: make animate
                        sdedit: null
                        status: processing
                        actions: null
                        guidance: null
                        n_frames: 450
                        priority: 2
                        operation: simple_compose
                        preset_id: null
                        created_at: '2025-10-06T15:10:26.875729Z'
                        n_variants: 1
                        project_id: null
                        request_id: null
                        generations: []
                        tracking_id: null
                        progress_pct: 0.9302178175176704
                        remix_config: null
                        inpaint_items:
                          - type: image
                            preset_id: null
                            crop_bounds: null
                            frame_index: 0
                            cameo_file_id: null
                            generation_id: null
                            upload_media_id: media_01k6x15tnzezbst05sth2qgd8r
                            source_end_frame: 0
                            uploaded_file_id: null
                            source_start_frame: 0
                          - type: image
                            preset_id: null
                            crop_bounds: null
                            frame_index: 0
                            cameo_file_id: null
                            generation_id: null
                            upload_media_id: media_01k6x15tzafwztz74t018v3enw
                            source_end_frame: 0
                            uploaded_file_id: null
                            source_start_frame: 0
                        interpolation: null
                        is_storyboard: null
                        failure_reason: null
                        organization_id: null
                        moderation_result:
                          code: null
                          type: passed
                          task_id: task_01k6x15vhrff09dkkqjrzwhm60
                          is_output_rejection: false
                          results_by_frame_index: {}
                        needs_user_review: false
                        queue_status_message: null
                        progress_pos_in_queue: null
                        num_unsafe_generations: 0
                        estimated_queue_wait_time: null
                    status: pending
                    status_update_time: 1759763621142
                '2':
                  summary: completed
                  value:
                    id: sora-2:task_01k6x15vhrff09dkkqjrzwhm60
                    width: 352
                    detail:
                      id: task_01k6x15vhrff09dkkqjrzwhm60
                      url: >-
                        https://example.com/?sample-video-src=1
                      input:
                        size: small
                        model: sy_ore
                        images:
                          - >-
                            https://example.com/?sample-input-image=1
                          - >-
                            https://example.com/?sample-input-image=2
                        prompt: make animate
                        orientation: portrait
                      status: completed
                      gif_url: >-
                        https://example.com/?sample-video-preview=1
                      draft_info:
                        id: gen_01k6x1bffaf3dr786harh8maqt
                        url: >-
                          https://example.com/?sample-video-src=1
                        kind: sora_draft
                        tags: []
                        title: null
                        width: 352
                        height: 640
                        prompt: make animate
                        task_id: task_01k6x15vhrff09dkkqjrzwhm60
                        encodings:
                          md:
                            path: >-
                              https://example.com/?sample-video-md=1
                          gif:
                            path: >-
                              https://example.com/?sample-video-preview=1
                          source:
                            path: >-
                              https://example.com/?sample-video-src=1
                          unfurl: null
                          source_wm:
                            path: >-
                              https://example.com/?sample-video-src=1
                          thumbnail:
                            path: >-
                              https://example.com/?sample-video-thumbnail=1
                        created_at: 1759763631.222531
                        generation_id: gen_01k6x1bffaf3dr786harh8maqt
                        draft_reviewed: false
                        creation_config:
                          prompt: make animate
                          task_id: null
                          n_frames: null
                          style_id: null
                          orientation: null
                          inpaint_image: null
                          cameo_profiles: null
                          remix_target_post: null
                        generation_type: ''
                        downloadable_url: >-
                          https://example.com/?sample-video-src=1
                      thumbnail_url: >-
                        https://example.com/?sample-video-thumbnail=1
                    height: 640
                    status: completed
                    video_url: >-
                      https://example.com/?sample-video-src=1
                    thumbnail_url: >-
                      https://example.com/?sample-video-thumbnail=1
                    status_update_time: 1759763651908
          headers: {}
          x-apifox-name: 成功
      security:
        - bearer: []
      x-apifox-folder: 视频模型/sora 视频生成/统一视频格式
      x-apifox-status: released
      x-run-in-apifox: https://app.apifox.com/web/project/7937429/apis/api-427877348-run
components:
  schemas: {}
  securitySchemes:
    bearer:
      type: http
      scheme: bearer
servers:
  - url: https://new.22codex.xyz
    description: 正式环境
security:
  - bearer: []

文档内容持续更新,请以控制台可用模型与接口为准。