Bỏ qua để đến nội dung

Gửi tác vụ tạo video

Xem Markdownllms.txt

API origin: https://api.openaihub.net. Chọn đúng nhóm API và model. Thông số dưới đây là bản tham chiếu kỹ thuật; chưa phải kết quả kiểm thử từng endpoint bằng tài khoản của bạn.

openapi: 3.0.1
info:
title: ''
description: ''
version: 1.0.0
paths:
/runwayml/v1/image_to_video:
post:
summary: Gửi tác vụ tạo video
deprecated: false
description: >-
Tạo video bằng cách dùng hình ảnh làm khung hình đầu tiên. Sau khi gửi
yêu cầu, `id` của tác vụ được trả về và được thăm dò qua `GET
/runwayml/v1/tasks/{task_id}`.
Tài liệu chính thức:
https://docs.dev.runwayml.com/api/#tag/Start-generating/paths/~1v1~1image_to_video/post
operationId: runway_sample
tags:
- OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Video/Đường băng
- Đường băng
parameters: []
requestBody:
content:
application/json:
schema:
type: object
required:
- model
- promptImage
- ratio
properties:
duration:
type: integer
enum:
- 5
- 10
description: Thời lượng video (giây)
model:
type: string
enum:
- gen4_turbo
- gen3a_turbo
- gen3a
description: Tên mô hình
examples:
- gen4_turbo
promptImage:
oneOf:
- type: string
description: URL hình ảnh đơn
- type: array
items:
type: object
properties:
position:
type: string
enum:
- first
- last
description: 'Định danh vị trí (ví dụ: đầu tiên / cuối cùng)'
uri:
type: string
description: URL hình ảnh
x-apifox-orders:
- position
- uri
x-apidog-orders:
- position
- uri
description: Mảng vị trí nhiều hình ảnh
description: Khung hình đầu tiên / hình ảnh tham chiếu
promptText:
type: string
description: Các từ khóa trong câu lệnh mô tả chiến dịch/nội dung
examples:
- Máy quay từ từ phóng to vào chủ thể
ratio:
type: string
enum:
- '1280:720'
- '720:1280'
- '1104:832'
- '832:1104'
- '960:960'
- '1584:672'
description: Tỷ lệ khung hình video
examples:
- '1280:720'
seed:
type: integer
description: giá trị khởi tạo ngẫu nhiên
watermark:
type: boolean
description: Có thêm hình mờ hay không
refName: RunwaySampleRequest
x-apifox-orders:
- duration
- model
- promptImage
- promptText
- ratio
- seed
- watermark
x-apidog-orders:
- duration
- model
- promptImage
- promptText
- ratio
- seed
- watermark
examples:
gen4_turbo:
value:
duration: 5
model: gen4_turbo
promptImage: https://example.com/start-frame.jpg
promptText: Máy quay từ từ phóng to
ratio: '1280:720'
summary: gen4_turbo
description: video từ ảnh
gen4_turbo_2:
value:
duration: 5
model: gen4_turbo
promptImage: https://www.bt.cn/bbs/template/qiao/style/image/btlogo.png
promptText: mèo nhảy múa
ratio: '1280:720'
watermark: false
summary: gen4_turbo_2
description: Gửi tác vụ tạo video
responses:
'200':
description: ''
content:
application/json:
schema:
type: object
required:
- id
- state
properties:
batch_id:
type: string
description: Mã lô
created_at:
type: string
description: Thời gian tạo
id:
type: string
description: Mã tác vụ
prompt:
type: string
description: Lời nhắc văn bản
state:
type: string
description: 'Trạng thái tác vụ, ví dụ: đang chờ / thành công / thất bại'
refName: RunwaySampleResponse
description: >-
Đối tượng tác vụ chuyển ảnh thành video của Runway sau khi gửi
(khớp với cấu trúc tác vụ chính thức)
x-apifox-orders:
- batch_id
- created_at
- id
- prompt
- state
x-apidog-orders:
- batch_id
- created_at
- id
- prompt
- state
examples:
example:
summary: example
value:
batch_id: ''
created_at: '2024-12-22T13:38:40.139Z'
id: 4665a07c-7641-4809-a133-10786201bb56
prompt: ''
state: đang chờ
headers: {}
x-apidog-name: ''
'400':
description: Yêu cầu không hợp lệ hoặc xác thực thất bại
content:
application/json:
schema:
type: object
required:
- error
properties:
error:
type: object
required:
- message
- type
properties:
message:
type: string
description: Thông báo lỗi (thường kết thúc bằng mã yêu cầu)
type:
type: string
description: Loại lỗi; các lỗi cổng cục bộ thường là new_api_error
examples:
- new_api_error
x-apifox-orders:
- message
- type
x-apidog-orders:
- message
- type
refName: NewApiError
x-apifox-orders:
- error
x-apidog-orders:
- error
examples:
example:
summary: example
value:
error:
message: >-
Yêu cầu không hợp lệ (mã yêu cầu:
20260805120000123456789AbCdEfGh)
type: new_api_error
headers: {}
x-apidog-name: Yêu cầu không hợp lệ hoặc xác thực thất bại
'401':
description: Khóa API bị thiếu hoặc không hợp lệ
content:
application/json:
schema:
type: object
required:
- error
properties:
error:
type: object
required:
- message
- type
properties:
message:
type: string
description: Thông báo lỗi (thường kết thúc bằng mã yêu cầu)
type:
type: string
description: Loại lỗi; các lỗi cổng cục bộ thường là new_api_error
examples:
- new_api_error
x-apifox-orders:
- message
- type
x-apidog-orders:
- message
- type
refName: NewApiError
x-apifox-orders:
- error
x-apidog-orders:
- error
examples:
example:
summary: example
value:
error:
message: >-
Mã thông báo không hợp lệ (request id:
20260805120000123456789AbCdEfGh)
type: new_api_error
headers: {}
x-apidog-name: Khóa API bị thiếu hoặc không hợp lệ
security: []
x-apidog-folder: OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Video/Đường băng
x-apidog-status: released
x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45209044-run
components:
schemas: {}
securitySchemes: {}
servers:
- url: https://api.openaihub.net
description: Prod Env
security: []