Bắt đầu
Endpoint API cần gọi
URL cơ sở, lựa chọn máy chủ và họ API nào sẽ gửi từng yêu cầu tới.
Modelflare sử dụng một khóa API trên nhiều giao thức. Đường bao JSON không giống nhau đối với mọi mô hình. Chọn gia đình trước, sau đó sao chép yêu cầu từ trang hướng dẫn hoặc mô hình phù hợp.
URL cơ sở
Phần tiêu đề “URL cơ sở”https://modelflare.dev/v1Lưu lượng EdgeOne hướng tới Trung Quốc có thể sử dụng https://origin.modelflare.dev/v1 cho cùng một ứng dụng. Chọn máy chủ trước khi gửi yêu cầu; không chuyển hướng POST giữa các máy chủ.
Khách hàng Anthropic là ngoại lệ: ANTHROPIC_BASE_URL là https://modelflare.dev (nguồn gốc trang web, không phải /v1). CLI Claude Code chính thức sẽ thêm chính đường dẫn Tin nhắn. Xem Claude Code.
Xác thực
Phần tiêu đề “Xác thực”Authorization: Bearer YOUR_MODELFLARE_API_KEYGửi tiêu đề này theo mọi yêu cầu, bao gồm cả việc thăm dò ý kiến và tải xuống video. Tạo khóa trong console. Chi tiết: Xác thực.
Gia đình
Phần tiêu đề “Gia đình”https://modelflare.devChat Completions
POST /v1/chat/completions Trò chuyện tương thích với OpenAI.
Responses
POST /v1/responses Codex và Grok Build.
Anthropic Messages
ANTHROPIC_BASE_URL=https://modelflare.dev CLI Claude Code tự thêm đường dẫn Tin nhắn.
Hình ảnh
POST /v1/images/generations Hình ảnh GPT, Hình ảnh Wan và Seedream.
Gemini gốc
POST /v1/models/{model}:generateContent Gemini. Gemini CLI sử dụng cách viết /v1beta.
Video
POST /v1/videos Tạo một nhiệm vụ: thăm dò ý kiến, sau đó tải kết quả xuống.
tài sản Seedance
POST /volc/asset/* Quản lý nhóm nội dung Seedance và ID phương tiện truyền thông phía nhà cung cấp.
Mô hình
GET /v1/models Phím hiện tại có thể gọi là gì.
| Gia đình | Mục điển hình | Sử dụng nó cho |
|---|---|---|
| Chat Completions | POST /v1/chat/completions |
Trò chuyện tương thích với OpenAI. Yêu cầu đầu tiên: Khởi động nhanh. |
| Responses | POST /v1/responses |
Codex và Grok Build. |
| Anthropic Messages | Anthropic | Claude Code. |
| Hình ảnh | POST /v1/images/generations |
Hình ảnh GPT, Hình ảnh Wan và Seedream. Các trường chính xác: mô hình hình ảnh. |
| Gemini gốc | POST /v1/models/{model}:generateContent |
Gemini; cũng được phục vụ trên origin.modelflare.dev. Gemini CLI xây dựng đường dẫn tương tự trong /v1beta, chỉ có modelflare.dev phục vụ. |
| Video | POST /v1/videos |
Seedance, Wan, Kling và các mô hình video không đồng bộ khác. Thăm dò GET /v1/videos/{task_id} và tải xuống GET /v1/videos/{task_id}/content. Đường bao chính xác: mô hình video. |
| tài sản Seedance | POST /volc/asset/* |
Tạo, truy vấn, cập nhật và xóa các nhóm nội dung và phương tiện phía nhà cung cấp. Xem Seedance quản lý tài sản. |
| Mô hình | GET /v1/models |
Liệt kê các model mà khóa hiện tại có thể gọi. |
Yêu cầu hình ảnh và video sai điểm cuối sẽ bị từ chối bằng unsupported_endpoint. Không gửi trường hình ảnh Gemini tới trường Hình ảnh /v1/images/* hoặc GPT tới generateContent. Không trộn các trường Chat Completions vào máy khách Responses hoặc Anthropic.
Hình ảnh và video hoạt động với khóa API thông minh Smart API hoặc khóa API nhóm media. URL kết quả có thể hết hạn; chuyển tập tin sau khi tác vụ video thành công.
Lệnh gọi quản lý nội dung Seedance chấp nhận các khóa giống nhau: Khóa API thông minh hoặc khóa API nhóm media. Việc tạo tài sản không đồng bộ; sử dụng GetAsset cho đến Active, sau đó chuyển asset://<ID> được trả về không thay đổi trong yêu cầu Seedance được hỗ trợ. Cổng giữ quyền sở hữu tài sản cho mỗi người dùng và không tính thêm phí quản lý tài nguyên riêng.
Liệt kê các model cho phím này
Phần tiêu đề “Liệt kê các model cho phím này”https://modelflare.dev/v1/modelscurl https://modelflare.dev/v1/models \ -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY"Phản hồi liệt kê các mô hình mà khóa hiện tại có thể gọi. Nó không thay thế cho Mô hình & Định giá, bao gồm giá, nhóm và nhãn giao thức. Sử dụng id chính xác trong trường JSON model. Xem Mô hình và nhóm.