Tổng quan LemonData API tương thích với OpenAI , điều đó có nghĩa là bạn có thể sử dụng OpenAI SDK chính thức chỉ với việc thay đổi URL cơ sở. Chúng tôi cũng hỗ trợ các định dạng yêu cầu gốc của Anthropic và Gemini .
URL cơ sở Xác thực Tất cả các endpoint API đều yêu cầu xác thực bằng Bearer token:
Authorization: Bearer sk-your-api-key
Lấy API key của bạn từ Dashboard .
Các Endpoint được hỗ trợ Chat & Tạo văn bản Endpoint Phương thức Mô tả /v1/chat/completionsPOST Hoàn thiện chat tương thích với OpenAI /v1/messagesPOST API tin nhắn tương thích với Anthropic /v1/responsesPOST API phản hồi của OpenAI
Embeddings & Rerank Endpoint Phương thức Mô tả /v1/embeddingsPOST Tạo text embeddings /v1/rerankPOST Xếp hạng lại tài liệu
Hình ảnh Endpoint Phương thức Mô tả /v1/images/generationsPOST Tạo hình ảnh từ văn bản /v1/images/editsPOST Chỉnh sửa hình ảnh
Âm thanh Endpoint Phương thức Mô tả /v1/audio/speechPOST Chuyển đổi văn bản thành giọng nói (TTS) /v1/audio/transcriptionsPOST Chuyển đổi giọng nói thành văn bản (STT)
Video Endpoint Phương thức Mô tả /v1/videos/generationsPOST Tạo tác vụ tạo video /v1/videos/generations/{id}GET Lấy trạng thái tác vụ video
Âm nhạc Endpoint Phương thức Mô tả /v1/music/generationsPOST Tạo tác vụ tạo nhạc /v1/music/generations/{id}GET Lấy trạng thái tác vụ nhạc
Tạo mô hình 3D Endpoint Phương thức Mô tả /v1/3d/generationsPOST Tạo tác vụ tạo mô hình 3D /v1/3d/generations/{id}GET Lấy trạng thái tác vụ 3D
Mô hình Endpoint Phương thức Mô tả /v1/modelsGET Liệt kê tất cả các mô hình có sẵn /v1/models/{model}GET Lấy thông tin mô hình cụ thể
Định dạng phản hồi Tất cả các phản hồi đều tuân theo một định dạng nhất quán:
Phản hồi thành công { "id" : "chatcmpl-abc123" , "object" : "chat.completion" , "created" : 1234567890 , "model" : "gpt-4o" , "choices" : [ ... ], "usage" : { "prompt_tokens" : 10 , "completion_tokens" : 20 , "total_tokens" : 30 } }
Tính minh bạch trong điều hướng (Routing) Tất cả các phản hồi đều bao gồm trường _routing với thông tin kênh:
{ "id" : "chatcmpl-abc123" , ..., "_routing" : { "channel" : { "id" : "ch_xxx" , "name" : "channel-name" , "provider" : "openai" , "channelType" : "PLATFORM" }, "cached" : false , "retryCount" : 0 } }
Trường Mô tả channel.idĐịnh danh kênh được sử dụng channel.providerNhà cung cấp thượng nguồn (openai, anthropic, v.v.) channel.channelTypePLATFORM (LemonData) hoặc PRIVATE (BYOK)cachedLiệu phản hồi có được cung cấp từ bộ nhớ đệm (cache) hay không retryCountSố lần thử lại (nếu có)
Phản hồi lỗi { "error" : { "message" : "Invalid API key provided" , "type" : "invalid_api_key" , "code" : "invalid_api_key" } }
Giới hạn tốc độ (Rate Limits) Giới hạn tốc độ dựa trên vai trò và có thể cấu hình bởi quản trị viên. Các giá trị mặc định:
Vai trò Yêu cầu/phút Người dùng 60 Đối tác 300 VIP 1,000 Quản trị viên Không giới hạn
Liên hệ bộ phận hỗ trợ để biết giới hạn tốc độ tùy chỉnh. Các giá trị chính xác có thể thay đổi tùy theo cấu hình tài khoản.
Các header giới hạn tốc độ được bao gồm trong tất cả các phản hồi:
X-RateLimit-Limit: 60 X-RateLimit-Remaining: 55 X-RateLimit-Reset: 1234567890
Đặc tả OpenAPI
Đặc tả OpenAPI Tải xuống bản đặc tả OpenAPI 3.0 đầy đủ
