Tạo video
Gửi trả về HTTP 202 với ID công việc ShareAI và URL thăm dò.
Trên trang này
https://api.shareai.now/api/v1/videosTạo video
- URL cơ sở
https://api.shareai.now- Xác thực
- Khóa API Bearer hoặc token truy cập OAuth đã được phê duyệt
- Phạm vi yêu cầu
inferenceormonetization_gateway
Gửi trả về HTTP 202 với một ShareAI job ID và URL polling. Gửi một Idempotency-Key tiêu đề ổn định để thử lại cùng một yêu cầu. Việc tái sử dụng khóa đó với đầu vào khác sẽ bị từ chối. Poll GET /api/v1/videos/{id} bằng cùng thông tin xác thực ban đầu. Các trạng thái bao gồm queued, pending, in_progress, finalizing, completed, failed và requires_review. Kết quả requires_review cần đội ngũ xác minh; polling không bao giờ bắt đầu một lần tạo khác.
Trước khi bạn bắt đầu#
Đặt SHAREAI_API_KEY trên máy chủ của bạn và thay thế placeholder model bằng một model hiện đang được kích hoạt. Không bao giờ để lộ khóa API trong mã trình duyệt. Model, tài khoản, thông tin xác thực và nhà cung cấp phải cho phép thực hiện thao tác này. Các cài đặt tùy chọn dưới đây yêu cầu hỗ trợ từ model; giới hạn an toàn của API không đảm bảo rằng mọi model đều hỗ trợ mọi giá trị.
Gửi một yêu cầu#
cURL
curl --fail-with-body --request POST "https://api.shareai.now/api/v1/videos" \
-H "Authorization: Bearer $SHAREAI_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: YOUR_UNIQUE_REQUEST_ID" \
--data '{
"model": "YOUR_ENABLED_VIDEOS_MODEL",
"prompt": "A slow camera move through a quiet forest.",
"duration": 8
}'Python
import json
import os
import urllib.request
payload = {'model': 'YOUR_ENABLED_VIDEOS_MODEL',
'prompt': 'A slow camera move through a quiet forest.',
'duration': 8}
headers = {'Content-Type': 'application/json', 'Idempotency-Key': 'YOUR_UNIQUE_REQUEST_ID'}
headers["Authorization"] = "Bearer " + os.environ["SHAREAI_API_KEY"]
request = urllib.request.Request('https://api.shareai.now/api/v1/videos', data=json.dumps(payload).encode(), headers=headers, method="POST")
with urllib.request.urlopen(request, timeout=180) as response:
result = json.load(response)
print(result)TypeScript
const response = await fetch("https://api.shareai.now/api/v1/videos", {
method: "POST",
headers: { Authorization: `Bearer ${process.env.SHAREAI_API_KEY}`, ...{"Content-Type": "application/json", "Idempotency-Key": "YOUR_UNIQUE_REQUEST_ID"} },
body: JSON.stringify({
"model": "YOUR_ENABLED_VIDEOS_MODEL",
"prompt": "A slow camera move through a quiet forest.",
"duration": 8
}),
});
if (!response.ok) throw new Error(await response.text());
const result = await response.json();
console.log(result);Các trường yêu cầu#
| Trường | Loại | Ý nghĩa và giới hạn |
|---|---|---|
model bắt buộc | chuỗi | Định danh mô hình công khai chính xác đã được kích hoạt. Phải khai báo thao tác này và được thông qua bởi thông tin xác thực của bạn. |
prompt bắt buộc | chuỗi | Lời nhắc tạo không rỗng, tối đa 256 KiB văn bản UTF-8. |
duration | số nguyên | Thời lượng video yêu cầu tùy chọn tính bằng giây, từ 1–600, bị giới hạn thêm bởi mô hình đã chọn. Thời lượng thực tế trả về quyết định việc tính phí theo thời lượng. |
resolution | chuỗi | Bộ chọn độ phân giải được mô hình hỗ trợ, tối đa 100 ký tự; phải khớp với biến thể biểu giá đã công bố. |
aspect_ratio | chuỗi | Bộ chọn tỷ lệ khung hình được mô hình hỗ trợ, tối đa 100 ký tự. |
size | chuỗi | Kích thước đầu ra được mô hình hỗ trợ, tối đa 100 ký tự, ví dụ 1024×1024. Không phải mọi mô hình đều hỗ trợ tùy chọn này. |
generate_audio | boolean | Bộ chọn nhạc nền video tùy chọn. Yêu cầu hỗ trợ mô hình và biến thể biểu giá tương ứng. |
seed | số nguyên | Hạt giống tùy chọn được mô hình hỗ trợ. Video yêu cầu một số nguyên không âm; khả năng tái tạo phụ thuộc vào trình thực thi. |
frame_images | mảng | Tối đa hai phần image_url, mỗi phần với frame_type là first_frame hoặc last_frame, không được trùng lặp. Không kết hợp frame_images và input_references. |
input_references | mảng | Tối đa 16 phần image_url được gõ với image_url.url được đặt thành một URL HTTPS hoặc URL dữ liệu hình ảnh được hỗ trợ. Yêu cầu hỗ trợ mô hình. |
provider | đối tượng | Tùy chọn ưu tiên định tuyến nhà cung cấp. Sử dụng provider.only cho các thẻ nhà cung cấp được chấp nhận, không phải tiền tố trong ID mô hình. Các hạn chế về tài khoản và thông tin xác thực vẫn được áp dụng. |
allow_temporary_retention | boolean | Chỉ video. Giá trị true rõ ràng cho phép lưu trữ tạm thời kết quả upstream trên các tuyến yêu cầu điều này. Bỏ qua/false giữ các tuyến đó không khả dụng. Xung đột với provider.zdr:true; các hoạt động khác giữ ZDR bắt buộc. |
Đọc kết quả#
Thành công trả về HTTP 202 với JSON. Gửi trả về HTTP 202 với một ShareAI job ID và URL polling. Gửi một Idempotency-Key tiêu đề ổn định để thử lại cùng một yêu cầu. Việc tái sử dụng khóa đó với đầu vào khác sẽ bị từ chối. Poll GET /api/v1/videos/{id} bằng cùng thông tin xác thực ban đầu. Các trạng thái bao gồm queued, pending, in_progress, finalizing, completed, failed và requires_review. Kết quả requires_review cần đội ngũ xác minh; polling không bao giờ bắt đầu một lần tạo khác.
Đơn vị thanh toán#
Các tuyến video khai báo đơn vị tính phí của chúng. Một tuyến tính phí theo giây được quyết toán dựa trên thời lượng đo được của mỗi tệp trả về, không phải thời lượng yêu cầu hoặc chi phí USD upstream. Thời lượng yêu cầu phải nằm trong khoảng từ 1 đến 600 giây và được mô hình hỗ trợ. Một khoản giữ tín dụng bảo thủ có thể bao phủ tối đa bốn đầu ra.
Chọn mã định danh model đã kích hoạt chính xác từ Console. Hoạt động được công bố và khả năng đầu vào/đầu ra của nó phải phù hợp với endpoint này; một model trò chuyện văn bản không thể thay thế cho một hoạt động khác. Các hạn chế về thông tin xác thực, nhà cung cấp và tài khoản của bạn vẫn được áp dụng.
Giá cả và sử dụng#
Mức giá được công bố bằng tín dụng AI EUR cho model, nhà cung cấp, đơn vị và biến thể đã chọn. Chỉ các yếu tố trong biểu giá đang hoạt động của nó mới bị tính phí. Một ước tính sẽ giữ trước tín dụng trước khi thực thi; phí cuối cùng sử dụng mức sử dụng được đo lường. Giá có thể phụ thuộc vào độ phân giải, định dạng đầu ra hoặc một dải sử dụng. Kiểm tra Console Usage để biết khoản ghi nợ ShareAI cuối cùng. Các trường chi phí thượng nguồn và byte phương tiện không được chuyển đổi thành số lượng token được tạo ra.
Truy cập và lỗi#
Sử dụng inference cho suy luận chi phí mạng được phê duyệt hoặc monetization_gateway cho một mức tăng giá của Builder được phê duyệt và các điều khoản thanh toán được chấp nhận. Quyền truy cập chỉ danh tính không cho phép chi tiêu. Xác thực, ủy quyền model, tín dụng không đủ, giới hạn tốc độ và lỗi thực thi trả về một cấu trúc error. Sau khi hết thời gian chờ hoặc gửi không chắc chắn, kiểm tra Usage hoặc công việc video trước khi tạo một yêu cầu khác có thể phải trả phí.
Lưu trữ video tạm thời#
Một số tuyến video cần lưu trữ tạm thời upstream để kết quả được tạo có thể được truy xuất. Chúng yêu cầu bạn allow_temporary_retention:true chấp nhận rõ ràng trên yêu cầu video đó. Bỏ qua điều này giữ các tuyến đó không khả dụng. Ngoại lệ này chỉ áp dụng cho video và không bao giờ cho phép đào tạo mô hình hoặc lưu trữ cho các hoạt động khác. Chính sách ZDR rõ ràng không thể bị làm suy yếu một cách âm thầm.
JSON
{"allow_temporary_retention": true}Kiểm tra trạng thái công việc#
https://api.shareai.now/api/v1/videos/{id}Đọc một lần tạo video với thông tin xác thực ban đầu của nó
- URL cơ sở
https://api.shareai.now- Xác thực
- Khóa API Bearer hoặc token truy cập OAuth đã được phê duyệt
- Phạm vi yêu cầu
inferenceormonetization_gateway
JSON
{
"id": "YOUR_JOB_ID",
"object": "video",
"status": "pending",
"created_at": 1793664000,
"polling_url": "/api/v1/videos/YOUR_JOB_ID"
}JSON ở trên minh họa các trường công việc ổn định, không phải một lần tạo thực tế. Poll đường dẫn ShareAI với cùng khóa, chờ giữa các lần kiểm tra. queued, pending, in_progress và finalizing nghĩa là chờ; completed hiển thị dữ liệu với các URL nội dung ShareAI; failed và requires_review nghĩa là dừng và kiểm tra. Đọc trạng thái thử lại sau các lỗi tạm thời, nhưng không gửi lại lần tạo tự động. Một thông tin xác thực khác hoặc bị thu hồi không thể truy xuất công việc.
cURL
curl --fail-with-body "https://api.shareai.now/api/v1/videos/YOUR_JOB_ID" \
-H "Authorization: Bearer $SHAREAI_API_KEY"Tải xuống kết quả#
Khi hoàn thành, mỗi mục dữ liệu chứa một URL nội dung ShareAI. Truy xuất GET /api/v1/videos/{id}/content?index=0 bằng cùng thông tin xác thực ban đầu. Endpoint hỗ trợ một phạm vi byte HTTP duy nhất. Các URL của Provider, vé riêng tư và thông tin xác thực của Provider không bao giờ được trả về. Polling và tải xuống không tạo ra yêu cầu suy luận thứ hai hoặc phí xử lý Monetization Gateway. Một công việc hoàn thành nghĩa là việc quyết toán đã được xác nhận trước khi tệp trở nên có thể tải xuống.
cURL
curl --fail-with-body "https://api.shareai.now/api/v1/videos/YOUR_JOB_ID/content?index=0" \
-H "Authorization: Bearer $SHAREAI_API_KEY" --output result.mp4frame_images tùy chọn phải chứa các phần image_url với first_frame hoặc last_frame. Sử dụng hình ảnh khung hoặc hình ảnh tham chiếu trong một yêu cầu, không sử dụng cả hai. Thời lượng, độ phân giải và tỷ lệ khung hình của mô hình có thể hạn chế hơn so với giới hạn an toàn của API. Webhooks và các URL callback tùy ý không được hỗ trợ.
Cập nhật lần cuối Tháng 11 3, 2026