Glosarium

Konsep, field, dan istilah error umum yang digunakan dalam dokumentasi bantuan

Dokumen ini menjelaskan konsep dan field umum yang digunakan di seluruh dokumentasi bantuan.

Akses & autentikasi

Istilah	Deskripsi
API Key / Token	Kunci akses yang diawali `sk-`, dikirim melalui `Authorization: Bearer`
Base URL	Alamat deployment gateway, mis. `http://www.mangoto.ai`
Bearer Token	Skema auth HTTP: `Authorization: Bearer sk-xxx`
Session	Sesi login konsol admin, digunakan untuk `/api/*` dan beberapa endpoint unduhan konten

Istilah	Deskripsi
model	ID model di body permintaan atau path; harus berupa `data[].id` yang dikembalikan oleh `/v1/models`
supported_endpoint_types	Jenis endpoint yang didukung model; menentukan kemampuan yang dapat digunakan
`openai`	Mendukung Chat / Completions
`openai-response`	Mendukung `/v1/responses`
`image-generation`	Mendukung `/v1/images/*`
`openai-video`	Mendukung endpoint generasi video
owned_by	Pengenal kepemilikan model (ID provider)
tags	Tag model (jika ada)

Istilah	Deskripsi
SSE	Format streaming Server-Sent Events, `Content-Type: text/event-stream`
stream	Field permintaan; saat `true`, mengembalikan aliran SSE
finish_reason	Alasan generasi berhenti: `stop`, `length`, `tool_calls`, `content_filter`
tool_calls	Panggilan fungsi/tool yang dimulai oleh model
usage	Objek penggunaan token, termasuk `prompt_tokens`, `completion_tokens`, dll.

Istilah	Deskripsi
response_format	Format respons gambar: `url` (default) atau `b64_json`
revised_prompt	Prompt yang ditulis ulang oleh beberapa model
quota	Konsumsi penagihan per permintaan (gambar `usage.quota`)

Istilah	Deskripsi
task_id	ID tugas video publik, berbentuk `task_xxxxxxxx`
Async task	Mengembalikan `task_id` segera saat dibuat; polling status, lalu unduh
status	Status tugas: `queued` → `in_progress` → `completed` / `failed`
progress	Progres tugas, 0–100
mode	Mode generasi untuk video multimodal yunsell (`t2v`, `first_frame`, `ref_image`, dll.)
assets	Array aset dalam permintaan yunsell, `[{ "role": "...", "url": "..." }]`
variant	Parameter unduhan konten: `video` (default) atau `thumbnail`
remixed_from_video_id	URL hasil video yang dikembalikan beberapa channel saat tugas selesai

mode	Deskripsi
`t2v`	Teks-ke-video
`i2v`	Gambar-ke-video
`first_frame`	Hasilkan video dari frame pertama
`first_last_frame`	Hasilkan video dari frame pertama dan terakhir
`ref_image`	Hasilkan video dari gambar referensi
`video_extend`	Perpanjang / lanjutkan video
`video_edit`	Pengeditan video cerdas

Istilah	Deskripsi
voice	Kode suara TTS dari `/v1/audio/voice/{model}` → `data[].code`
response_format	Format output audio: `mp3`, `wav`, `opus`, dll.
Channel voices	`name` sama dengan `code`; berasal dari konfigurasi channel
Platform voice library	`name` adalah nama tampilan; `code` adalah `voice_key`

Istilah	Deskripsi
Skills	Paket skill berbasis V1 API (`yunsell-ai-skills`), termasuk `SKILL.md`, untuk panggilan Agent dalam percakapan
yunsell-ai-skills	Nama paket skill resmi YunSell AI yang mencakup generasi gambar, video, dan audio
YUNSELL_BASE_URL	Variabel lingkungan untuk URL gateway Skills
YUNSELL_API_KEY	Variabel lingkungan untuk API Key Skills
Supported platforms	Klien Agent seperti Claude, Cursor, Codex, OpenClaw, Hermes, dan NemoClaw

Istilah	Deskripsi
MCP	Model Context Protocol; jalur integrasi Agent lain yang memanggil Tools melalui endpoint `/mcp`
Tool	Kemampuan yang dapat dipanggil yang diekspos MCP, mis. `generate_image`, `create_video`
mcpServers	Kunci konfigurasi MCP klien; nama yang disarankan adalah `yunsell`
Mcp-Session-Id	ID sesi Streamable HTTP; harus disertakan pada permintaan berikutnya
next_poll_after_sec	Interval polling video yang disarankan (default 10 detik)

Istilah	Deskripsi
Standard error	Format `{ "error": { "message", "type", "code" } }`
Task error	Format `{ "code", "message" }`, umum untuk tugas video
Gateway extended error	Format `{ "success": false, "message" }`, umum untuk daftar model

Istilah	Deskripsi
Token billing	Ditagih berdasarkan token input/output; terlihat di `usage` teks
Per-request billing	Ditagih berdasarkan jumlah permintaan; terlihat di `usage.quota` gambar
Per-second billing	Video mungkin ditagih berdasarkan durasi yang dihasilkan (tergantung konfigurasi model)

Memilih Integrasi

Pilih V1 Open API, Skills, atau MCP berdasarkan skenario penggunaan Anda

Konvensi Umum V1 API

Autentikasi, penagihan, objek bersama, dan format respons error untuk V1 Open API