# "Gửi tác vụ tạo video" Nguồn: https://docs.openaihub.net/api-45209044/ > 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 Specification ```yaml 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: [] ```