Langsung ke konten utama

Documentation Index

Fetch the complete documentation index at: https://docs.tokenlab.sh/llms.txt

Use this file to discover all available pages before exploring further.

​
Gambaran Umum

Dify bekerja dengan baik bersama TokenLab melalui alur penyedia model yang kompatibel dengan OpenAI. Untuk versi Dify saat ini, jalur yang paling aman biasanya adalah:
  • pilih penyedia bawaan OpenAI
  • atur API key TokenLab Anda
  • atur URL dasar kustom ke https://api.tokenlab.sh/v1
Beberapa build Dify yang lebih lama menampilkan ini sebagai OpenAI-API-compatible alih-alih penyedia bawaan OpenAI dengan kolom URL dasar kustom. Jika UI Dify Anda terlihat berbeda, gunakan alur penyedia kustom yang kompatibel dengan OpenAI yang paling mendekati dan tersedia di versi tersebut.
Ini adalah jalur integrasi yang berorientasi chat-completions. Ini tidak boleh dipahami sebagai jaminan bahwa Dify mengekspos perilaku Responses atau WebSocket yang sama seperti integrasi Codex khusus.
Jenis: Framework atau platformJalur utama: Jalur chat kompatibel OpenAITingkat dukungan: Didukung dengan batas lingkup

​
Prasyarat

  • Akun TokenLab dengan akses API
  • Dify Cloud atau Dify yang di-host sendiri

​
Langkah Konfigurasi

​
Langkah 1: Dapatkan API Key Anda

  1. Masuk ke TokenLab Dashboard
  2. Buka API Keys
  3. Buat atau salin API key yang diawali dengan sk-

​
Langkah 2: Konfigurasikan Penyedia

1

Buka Penyedia Model

Di Dify, buka Settings → Model Providers
2

Pilih OpenAI

Buka pengaturan penyedia OpenAI. Jika versi Dify Anda tidak menawarkan URL dasar kustom di sini, gunakan opsi penyedia kustom yang kompatibel dengan OpenAI yang tersedia di versi tersebut sebagai gantinya.
3

Masukkan Pengaturan TokenLab

Gunakan nilai berikut:
BidangNilai
Kunci APIsk-your-tokenlab-key
URL Basis API / URL Basis Kustomhttps://api.tokenlab.sh/v1
4

Tambahkan Model

Tambahkan model yang ingin Anda gunakan, misalnya:
  • gpt-5.4
  • gpt-5-mini
  • gpt-4o
  • claude-sonnet-4-6
  • claude-opus-4-6
  • gemini-2.5-flash
  • gemini-2.5-pro
  • deepseek-r1

​
Langkah 3: Uji Koneksi

  1. Pilih satu model seperti gpt-5-mini atau gpt-4o
  2. Kirim prompt uji
  3. Pastikan Dify menerima respons yang valid

​
Embeddings untuk Knowledge Base

Untuk RAG dan pengindeksan knowledge base, tambahkan model embedding seperti:
  • text-embedding-3-small
  • text-embedding-3-large
Lalu atur model tersebut sebagai model embedding default di knowledge base yang relevan atau pada pengaturan aplikasi.

​
Peran Model yang Direkomendasikan

Kasus PenggunaanModel yang Disarankan
Chat defaultgpt-5.4, gpt-5-mini, gpt-4o
Penalaran mendalamgpt-5.4, claude-opus-4-6, deepseek-r1
Cepat/murahgpt-5-mini, gemini-2.5-flash
Embeddingstext-embedding-3-small, text-embedding-3-large

​
Praktik Terbaik

Pada versi Dify yang lebih baru, penyedia OpenAI bawaan dengan URL dasar kustom biasanya merupakan pengaturan yang paling rapi untuk TokenLab.
Gunakan gpt-5-mini atau gemini-2.5-flash saat melakukan iterasi, lalu pindahkan alur kerja yang lebih berat ke model yang lebih kuat hanya jika diperlukan.
Sebagian besar alur Dify menggunakan perilaku chat yang kompatibel dengan OpenAI. Jika Anda memerlukan Responses khusus Codex atau perilaku WebSocket, gunakan integrasi Codex khusus alih-alih Dify.

​
Pemecahan Masalah

  • Verifikasi bahwa URL dasar persis https://api.tokenlab.sh/v1
  • Hapus trailing slash jika Dify menduplikasinya
  • Pastikan server Dify dapat menjangkau TokenLab melalui internet publik
  • Periksa kembali API key
  • Pastikan key aktif di dashboard TokenLab
  • Pastikan nilai yang ditempel ke Dify tidak mengandung spasi tambahan atau baris baru
  • Verifikasi nama model secara persis
  • Tambahkan ulang entri model jika antarmuka penyedia menyimpan cache nilai yang lebih lama
  • Periksa ketersediaan model saat ini di docs atau dashboard TokenLab