Chuyển đến nội dung chính

​
1. Định dạng tương thích OpenAI

Phù hợp với hầu hết các kịch bản tích hợp mới, nên ưu tiên cân nhắc:
  • POST /v1/chat/completions
  • POST /v1/responses
  • GET /v1/responses/{response_id}
  • POST /v1/images/generations
  • POST /v1/images/edits
  • POST /v1/videos
  • GET /v1/videos/{task_id}
Đặc điểm:
  • Hệ sinh thái SDK trưởng thành
  • Phong cách các trường thống nhất
  • Phù hợp để chuyển đổi giữa nhiều mô hình

​
2. Định dạng gốc của mô hình

Khi bản thân mô hình yêu cầu các trường chuyên dụng, cấu trúc nhiệm vụ chuyên dụng hoặc giao thức truy vấn gốc, hãy công khai giao diện gốc:
  • Seedance：/api/v3/contents/generations/tasks
  • HappyHorse: /api/v1/services/aigc/video-generation/video-synthesis và /api/v1/tasks/{task_id}
  • Vidu：/ent/v2/text2video、/ent/v2/img2video、/ent/v2/start-end2video、/ent/v2/reference2video 和 /ent/v2/tasks/{task_id}/creations
  • Omni và Veo: gemini-omni sử dụng /v1/videos hoặc /api/v3/contents/generations/tasks; đường dẫn dự trữ gốc của Veo là /v1beta/models/{model}:predictLongRunning và /v1beta/{operation_name}
  • Gemini tạo hình ảnh: /v1beta/models/{model}:generateContent
  • Tạo nhạc: /suno/submit/music và /suno/fetch/{task_id}, hỗ trợ chế độ mô tả bằng prompt, nhạc nhẹ/nhạc đệm thuần, chế độ nâng cao cho lời bài hát
gemini-omni là tên mô hình video công khai, không cần quan tâm đến mô hình upstream nội bộ; khi gọi video ưu tiên dùng /v1/videos, cũng có thể dùng định dạng tác vụ Seedance /api/v3/contents/generations/tasks. mode=t2v/r2v/edit lần lượt biểu thị tạo video từ văn bản, tạo theo tham chiếu và chỉnh sửa video; trường thời lượng sẽ tự động khớp với các mốc 4 / 6 / 8 / 10 giây. Phù hợp cho:
  • Có nhiều trường đặc thù của mô hình
  • Cần cấu trúc body request gốc
  • Cần duy trì sự gần gũi với định dạng chính thức của thượng nguồn (upstream)

​
3. Giao diện video chuyên dụng của mô hình

Hiện tại vẫn công khai một số ít giao diện chuyên dụng của mô hình, ví dụ:
  • POST /kling/v1/videos/text2video
  • POST /kling/v1/videos/image2video Phù hợp cho:
  • Đã tích hợp dựa trên giao thức chuyên dụng của mô hình tương ứng
  • Cần sử dụng chế độ tham số chuyên dụng của mô hình đó

​
4. Gợi ý lựa chọn

  1. Dự án mới ưu tiên sử dụng định dạng tương thích OpenAI.
  2. Nếu định dạng tương thích không thể bao quát các trường đặc thù của mô hình, hãy chuyển sang định dạng gốc.
  3. Giao diện nhiệm vụ dài nên phân biệt rõ ràng giữa “Giao diện tạo” và “Giao diện truy vấn
  4. Khi một mô hình có nhiều định dạng gọi, hãy căn cứ vào các trường được hỗ trợ trên trang giao diện tương ứng, không dùng lẫn lộn body request.