Ringkasan
API LemonData bersifat OpenAI-compatible , yang berarti Anda dapat menggunakan SDK resmi OpenAI hanya dengan mengubah base URL. Kami juga mendukung format permintaan asli Anthropic dan Gemini .
Base URL
Autentikasi
Semua endpoint API memerlukan autentikasi menggunakan token Bearer:
Authorization: Bearer sk-your-api-key
Dapatkan API key Anda dari Dashboard .
Endpoint yang Didukung
Chat & Generasi Teks
Endpoint Metode Deskripsi /v1/chat/completionsPOST Chat completion yang kompatibel dengan OpenAI /v1/messagesPOST API pesan yang kompatibel dengan Anthropic /v1/responsesPOST API Respons OpenAI
Embeddings & Rerank
Endpoint Metode Deskripsi /v1/embeddingsPOST Buat embedding teks /v1/rerankPOST Urutkan ulang (rerank) dokumen
Gambar
Endpoint Metode Deskripsi /v1/images/generationsPOST Hasilkan gambar dari teks /v1/images/editsPOST Edit gambar
Audio
Endpoint Metode Deskripsi /v1/audio/speechPOST Text-to-speech (TTS) /v1/audio/transcriptionsPOST Speech-to-text (STT)
Video
Endpoint Metode Deskripsi /v1/videos/generationsPOST Buat tugas pembuatan video /v1/videos/generations/{id}GET Dapatkan status tugas video
Musik
Endpoint Metode Deskripsi /v1/music/generationsPOST Buat tugas pembuatan musik /v1/music/generations/{id}GET Dapatkan status tugas musik
Generasi 3D
Endpoint Metode Deskripsi /v1/3d/generationsPOST Buat tugas pembuatan model 3D /v1/3d/generations/{id}GET Dapatkan status tugas 3D
Model
Endpoint Metode Deskripsi /v1/modelsGET Daftar semua model yang tersedia /v1/models/{model}GET Dapatkan info model spesifik
Semua respons mengikuti format yang konsisten:
Respons Berhasil
{
"id" : "chatcmpl-abc123" ,
"object" : "chat.completion" ,
"created" : 1234567890 ,
"model" : "gpt-4o" ,
"choices" : [ ... ],
"usage" : {
"prompt_tokens" : 10 ,
"completion_tokens" : 20 ,
"total_tokens" : 30
}
}
Transparansi Routing
Semua respons menyertakan field _routing dengan informasi saluran (channel):
{
"id" : "chatcmpl-abc123" ,
...,
"_routing" : {
"channel" : {
"id" : "ch_xxx" ,
"name" : "channel-name" ,
"provider" : "openai" ,
"channelType" : "PLATFORM"
},
"cached" : false ,
"retryCount" : 0
}
}
Field Deskripsi channel.idPengidentifikasi saluran yang digunakan channel.providerPenyedia upstream (openai, anthropic, dll.) channel.channelTypePLATFORM (LemonData) atau PRIVATE (BYOK)cachedApakah respons dilayani dari cache retryCountJumlah upaya percobaan ulang (jika ada)
Respons Kesalahan (Error)
{
"error" : {
"message" : "Invalid API key provided" ,
"type" : "invalid_api_key" ,
"code" : "invalid_api_key"
}
}
Batasan Laju (Rate Limits)
Batasan laju (rate limits) berbasis peran dan dapat dikonfigurasi oleh administrator. Nilai default:
Peran Permintaan/menit User 60 Partner 300 VIP 1,000 Admin Tanpa Batas
Hubungi dukungan untuk batasan laju khusus. Nilai tepatnya dapat bervariasi tergantung konfigurasi akun.
Header batasan laju disertakan dalam semua respons:
X-RateLimit-Limit: 60
X-RateLimit-Remaining: 55
X-RateLimit-Reset: 1234567890
Spesifikasi OpenAPI
Spesifikasi OpenAPI Unduh spesifikasi lengkap OpenAPI 3.0