API

Hình ảnh & video

Tạo hình ảnh và video bằng các mô hình BytePlus mà Valefront bán (Seedream cho hình ảnh, Seedance cho video), dùng cùng khóa API như chat. Mỗi lần tạo được tính theo giá chính thức của nhà cung cấp, trừ vào số dư của bạn.

Hình ảnh

POST https://llm.valefront.com/v1/images/generations với mô hình, câu lệnh và tùy chọn size (ví dụ 1024x1024), n (1 đến 4) và response_format (url hoặc b64_json).

curl https://llm.valefront.com/v1/images/generations \
  -H "Authorization: Bearer $VALEFRONT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"seedream-4-0-250828","prompt":"Một chiếc lá xanh trên nền trắng","size":"1024x1024"}'

Kết quả liệt kê các hình ảnh và chi phí:

{"created":1793927400,"model":"seedream-4-0-250828","provider":"BytePlus",
 "data":[{"url":"https://…"}],"cost":0.03,"usage":{"images":1}}

Đường dẫn hình ảnh chỉ tồn tại tạm thời: hãy tải về những gì bạn muốn giữ.

Video

Một video cần từ 30 giây đến vài phút, nên đây là một tác vụ: bắt đầu tác vụ, rồi kiểm tra cho đến khi hoàn tất.

POST https://llm.valefront.com/v1/videos với mô hình, câu lệnh và tùy chọn duration (giây), resolution (480p, 720p, hoặc 1080p nếu mô hình hỗ trợ) và ratio (ví dụ 16:9):

curl https://llm.valefront.com/v1/videos \
  -H "Authorization: Bearer $VALEFRONT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"seedance-1-0-pro-fast-251015","prompt":"Sóng biển nhẹ lúc bình minh","duration":5,"resolution":"720p"}'

Kết quả trả về 202 cùng tác vụ:

{"id":"video_2274b71f…","object":"video","status":"queued","model":"seedance-1-0-pro-fast-251015","duration":5,"resolution":"720p"}

Sau đó kiểm tra bằng GET /v1/videos/{id} (vài giây một lần) cho đến khi status là succeeded hoặc failed:

curl https://llm.valefront.com/v1/videos/video_2274b71f… \
  -H "Authorization: Bearer $VALEFRONT_KEY"

{"id":"video_2274b71f…","status":"succeeded","url":"https://…mp4","cost":0.103818}

Chỉ khóa đã bắt đầu video mới đọc được video đó.

Giá và thanh toán

  • Hình ảnh tính theo từng ảnh; video tính theo triệu token của video hoàn chỉnh, theo độ phân giải. Xem Mô hình & bảng giá hoặc danh sách media trong /v1/pricing.
  • Video được tính phí một lần, khi đã hoàn tất, theo số token thực tế. Video lỗi không mất phí.
  • Hình ảnh và video được trả từ số dư; token miễn phí chỉ dùng cho chat.
  • Ghi đúng tên mô hình; danh sách mô hình hình ảnh và video có trong /v1/pricing.

Thử không cần viết mã

Playground trên bảng điều khiển có thẻ Hình ảnh và Video: chọn mô hình, viết câu lệnh, xem giá trước khi tạo.