Lewati ke konten
Buka CastalyKonsol

Mulailah

Memilih endpoint API

URL dasar, pilihan host, dan keluarga API mana yang menjadi tujuan pengiriman setiap permintaan.

Modelflare menggunakan satu kunci API di beberapa protokol. Amplop JSON tidak sama untuk setiap model. Pilih keluarga terlebih dahulu, lalu salin permintaan dari halaman panduan atau model yang cocok.

https://modelflare.dev/v1

Lalu lintas EdgeOne yang terhubung ke Tiongkok dapat menggunakan https://origin.modelflare.dev/v1 untuk aplikasi yang sama. Pilih host sebelum mengirim permintaan; jangan mengalihkan POST dalam penerbangan antar host.

Klien Anthropic adalah pengecualian: ANTHROPIC_BASE_URL adalah https://modelflare.dev (asal situs, bukan /v1). CLI resmi Claude Code menambahkan jalur Pesan itu sendiri. Lihat Claude Code.

Authorization: Bearer YOUR_MODELFLARE_API_KEY

Kirim header ini pada setiap permintaan, termasuk polling video dan download. Buat kunci di konsol . Detail: Otentikasi.

Satu kunci API Modelflarehttps://modelflare.dev

Chat Completions

POST /v1/chat/completions

Obrolan yang kompatibel dengan OpenAI.

Responses

POST /v1/responses

Codex dan Grok Build.

Anthropic Messages

ANTHROPIC_BASE_URL=https://modelflare.dev

Claude Code CLI menambahkan jalur Pesan itu sendiri.

Gambar

POST /v1/images/generations

Gambar GPT, Gambar Wan, dan Seedream.

Gemini asli

POST /v1/models/{model}:generateContent

Model gambar Gemini. Gemini CLI menggunakan ejaan /v1beta itu sendiri.

Video

POST /v1/videos

Membuat tugas: polling, lalu unduh hasilnya.

Seedance aset

POST /volc/asset/*

Kelola grup aset Seedance dan ID media sisi penyedia.

Model

GET /v1/models

Apa yang dapat dipanggil oleh kunci saat ini.

Satu kunci dan satu host, tetapi kontrak permintaan berbeda per keluarga. Tabel di bawah ini menghubungkan ke halaman panduan atau model untuk masing-masingnya.
Keluarga Entri biasa Gunakan untuk
Chat Completions POST /v1/chat/completions Obrolan yang kompatibel dengan OpenAI. Permintaan pertama: Mulai Cepat.
Responses POST /v1/responses Codex dan Grok Build.
Anthropic Messages Anthropic. Claude Code.
Gambar POST /v1/images/generations Gambar GPT, Gambar Wan, dan Seedream. Bidang persisnya: model gambar.
Gemini asli POST /v1/models/{model}:generateContent Model gambar Gemini; juga disajikan di origin.modelflare.dev. Gemini CLI membangun jalur yang sama di bawah /v1beta, yang hanya dilayani oleh modelflare.dev.
Video POST /v1/videos Seedance, Wan, Kling, dan model video asinkron lainnya. Jajak pendapat GET /v1/videos/{task_id} dan unduh GET /v1/videos/{task_id}/content. Amplop persis: model video.
Seedance aset POST /volc/asset/* Membuat, menanyakan, memperbarui, dan menghapus grup aset dan media sisi penyedia. Lihat Seedance manajemen aset.
Model GET /v1/models Daftar model yang dapat dipanggil oleh kunci saat ini.

Permintaan gambar dan video titik akhir yang salah ditolak dengan unsupported_endpoint. Jangan kirim kolom gambar Gemini ke /v1/images/* atau kolom Gambar GPT ke generateContent. Jangan mencampur kolom Chat Completions ke dalam klien Responses atau Anthropic.

Gambar dan video berfungsi dengan Smart API Key atau kunci API grup media. URL hasil dapat kedaluwarsa; mentransfer file setelah tugas video berhasil.

Seedance menerima kunci yang sama: Kunci API Cerdas atau kunci API grup media. Pembuatan aset tidak sinkron; gunakan GetAsset hingga Active, lalu teruskan asset://<ID> yang dikembalikan tanpa perubahan dalam permintaan Seedance yang didukung. Gateway mempertahankan kepemilikan aset per pengguna dan tidak menambahkan biaya pengelolaan sumber daya terpisah.

GEThttps://modelflare.dev/v1/models
Terminal windowbash
curl https://modelflare.dev/v1/models \
-H "Authorization: Bearer YOUR_MODELFLARE_API_KEY"

Daftar respons memodelkan kunci saat ini yang dapat dipanggil. Ini bukan pengganti Model & Harga, yang mencakup harga, grup, dan label protokol. Gunakan id yang tepat di bidang JSON model. Lihat Model dan grup.