Mulai Cepat
Gateway YunSell AI menawarkan tiga opsi integrasi utama:
| Opsi | Cocok untuk | Dokumentasi |
|---|---|---|
| V1 Open API | Integrasi backend, mobile, dan SDK pihak ketiga | Konvensi Umum |
| Skills | Agent seperti Claude, Cursor, Codex, OpenClaw, Hermes, dan NemoClaw | Skills |
| Layanan MCP | Klien yang terhubung melalui protokol MCP | Koneksi & Konfigurasi |
Panduan ini membantu Anda menyelesaikan panggilan API pertama dalam sekitar 5 menit. Ganti sk-xxx pada contoh dengan API Key Anda.
1. Dapatkan API Key
Buat API Key (token) di konsol admin YunSell AI. Formatnya biasanya sk-xxxxxxxx.
Jika perlu membatasi model atau mengonfigurasi daftar putih IP, selesaikan pengaturan token tersebut sebelum menggunakan kunci di integrasi Anda.
2. Daftar model yang tersedia
curl http://www.mangoto.ai/v1/models \
-H "Authorization: Bearer sk-xxx"
Respons yang berhasil mengembalikan success: true dan daftar model data[]. Catat data[].id yang ingin Anda gunakan, lalu periksa supported_endpoint_types untuk memastikan kemampuan yang didukung model tersebut.
Lihat API Model.
3. Pilih endpoint pertama berdasarkan skenario
Obrolan teks (paling umum)
curl http://www.mangoto.ai/v1/chat/completions \
-H "Authorization: Bearer sk-xxx" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-4o",
"messages": [{"role": "user", "content": "Hello"}]
}'
Lihat API Teks.
Teks-ke-gambar
curl http://www.mangoto.ai/v1/images/generations \
-H "Authorization: Bearer sk-xxx" \
-H "Content-Type: application/json" \
-d '{
"model": "dall-e-3",
"prompt": "A cat on a windowsill",
"size": "1024x1024",
"response_format": "url"
}'
Lihat API Gambar.
Pembuatan video (asinkron)
# 1. Buat tugas
curl http://www.mangoto.ai/v1/videos \
-H "Authorization: Bearer sk-xxx" \
-H "Content-Type: application/json" \
-d '{
"model": "sora-2",
"prompt": "A cat walking on the beach at sunset",
"size": "1280x720",
"seconds": 8
}'
# 2. Polling status (ganti task_xxx dengan id yang dikembalikan di atas)
curl http://www.mangoto.ai/v1/videos/task_xxx \
-H "Authorization: Bearer sk-xxx"
# 3. Unduh setelah selesai
curl -L http://www.mangoto.ai/v1/videos/task_xxx/content \
-H "Authorization: Bearer sk-xxx" \
-o output.mp4
Lihat API Video.
Teks-ke-ucapan
# 1. Daftar suara
curl http://www.mangoto.ai/v1/audio/voice/tts-1 \
-H "Authorization: Bearer sk-xxx"
# 2. Sintesis ucapan
curl http://www.mangoto.ai/v1/audio/speech \
-H "Authorization: Bearer sk-xxx" \
-H "Content-Type: application/json" \
-d '{
"model": "tts-1",
"input": "Hello world",
"voice": "alloy",
"response_format": "mp3"
}' \
-o speech.mp3
Lihat API Audio.
4. Gunakan Skills di Agent (opsional)
Jika Anda menggunakan platform Agent seperti Claude, Cursor, Codex, OpenClaw, Hermes, atau NemoClaw:
- Unduh dan ekstrak
yunsell-ai-skills.zipke direktori Skills Agent - Konfigurasi
yunsell-ai-skills/.env:
YUNSELL_BASE_URL=http://www.mangoto.ai
YUNSELL_API_KEY=sk-xxx
- Jelaskan kebutuhan generasi Anda langsung dalam percakapan
Lihat Skills.
5. Peta dokumentasi
Memulai
- Memilih Integrasi — REST vs Skills vs MCP
- Glosarium — Konsep umum
V1 Open API (12 endpoint)
Layanan MCP
Skills
6. Langkah selanjutnya
| Tujuan | Baca |
|---|---|
| Memilih antara REST / Skills | Memilih Integrasi |
| Mencari parameter endpoint lengkap | Dokumentasi kemampuan API |
| Memanggil generasi multimodal dari Agent | Skills |
| Memahami error dan penagihan | Konvensi Umum · Respons Error |
Konvensi singkat: Base URL http://www.mangoto.ai · Autentikasi Authorization: Bearer sk-xxx · API publik /v1/* · MCP /mcp