Model and Modality Playbooks22 September 2026Flatkey Team

Akses API DeepSeek Melalui Router yang Kompatibel dengan OpenAI

Siapkan akses API DeepSeek melalui kunci DeepSeek langsung atau router Flatkey yang kompatibel dengan OpenAI, dengan pengecekan model, log, tinjauan harga, dan rollback.

Akses API DeepSeek Melalui Router yang Kompatibel dengan OpenAI adalah pola penyiapan praktis bagi indie hacker yang ingin memakai model DeepSeek tanpa menjadikan setiap pilihan penyedia sebagai integrasi SDK baru.

Ada dua jalur yang rapi. Jalur langsung DeepSeek menggunakan kunci API DeepSeek, base URL DeepSeek yang kompatibel dengan OpenAI, dan nama model DeepSeek. Jalur router menggunakan base URL Flatkey yang kompatibel dengan OpenAI, kunci API Flatkey, dan ID model DeepSeek yang tersedia untuk akun Anda. Keduanya bisa berfungsi. Pilihan yang tepat bergantung pada apakah DeepSeek adalah satu-satunya keluarga model Anda atau hanya salah satu rute dalam produk multi-model.

Panduan ini menunjukkan cara menyiapkan Akses API DeepSeek Melalui Router yang Kompatibel dengan OpenAI, cara menjaga jalur penyedia langsung tetap mudah di-debug, dan apa yang perlu diverifikasi sebelum trafik produksi berpindah.

Jawaban Cepat: Akses API DeepSeek Melalui Router yang Kompatibel dengan OpenAI

Untuk aplikasi bergaya OpenAI, akses API DeepSeek memiliki dua jalur praktis.

Keputusan	API DeepSeek Langsung	DeepSeek melalui Flatkey
Kunci API	Kunci API DeepSeek	Kunci API Flatkey
Base URL	`https://api.deepseek.com`	`https://router.flatkey.ai/v1`
Opsi format Anthropic	`https://api.deepseek.com/anthropic`	Gunakan bentuk API Flatkey yang didukung rute Anda
Nama model DeepSeek saat ini yang perlu dicek	`deepseek-flash`, `deepseek-v4-pro`	ID model DeepSeek yang dapat diakses akun dari `/v1/models` Flatkey dan direktori model
Kecocokan terbaik	Prototipe khusus DeepSeek atau integrasi spesifik penyedia	Aplikasi multi-model yang ingin satu klien, satu kunci, satu tinjauan penggunaan, dan fallback yang lebih mudah
Pengecekan operasional	Dashboard DeepSeek, dokumen penyedia, tabel harga saat ini	Daftar model Flatkey, log penggunaan, halaman harga, halaman status, dan manifest rollback

Gunakan jalur langsung ketika DeepSeek adalah satu-satunya model yang Anda butuhkan dan kontrol di tingkat penyedia adalah yang paling penting. Gunakan Flatkey ketika DeepSeek berdampingan dengan GPT, Claude, Gemini, Qwen, model media, atau rute agen coding di balik klien yang sama yang kompatibel dengan OpenAI.

Apa yang Dikonfirmasi DeepSeek Tentang Kompatibilitas API

Dokumentasi API DeepSeek saat ini menyatakan bahwa API DeepSeek menggunakan format API yang kompatibel dengan OpenAI dan Anthropic. Base URL format OpenAI adalah:

https://api.deepseek.com

DeepSeek juga mendokumentasikan base URL format Anthropic:

https://api.deepseek.com/anthropic

Dokumentasi yang sama mencantumkan deepseek-flash dan deepseek-v4-pro sebagai opsi model. Mereka juga menyebutkan bahwa nama lama deepseek-v4-flash dan deepseek-v4-flash-vision-exp masih diterima demi kompatibilitas, tetapi permintaan tersebut dilayani oleh DeepSeek-V4.1-Flash dan dikenakan biaya dengan harga Flash. Untuk kode baru, perlakukan nama lama sebagai risiko migrasi, bukan sebagai nama untuk disalin ke produk baru.

Halaman harga DeepSeek saat ini mendeskripsikan deepseek-flash sebagai DeepSeek-V4.1-Flash dan deepseek-v4-pro sebagai DeepSeek-V4-Pro-0813. Halaman tersebut juga mencantumkan panjang konteks 1M dan output maksimum 384K, dengan dukungan output JSON, panggilan tool, Responses API, dan Anthropic API untuk kedua model. Dukungan vision tercantum untuk Flash dan tidak untuk Pro. Periksa halaman harga DeepSeek secara langsung sebelum memublikasikan harga yang tepat di dokumentasi Anda sendiri karena tabel menggunakan tarif token puncak dan nonpuncak.

Apa yang Diubah Flatkey

Flatkey tidak menghapus kebutuhan untuk memilih ID model DeepSeek yang valid. Yang berubah adalah di mana rute dikonfigurasi dan di mana Anda memverifikasi hasilnya.

Dokumentasi quickstart dan model API Flatkey menggunakan base URL yang kompatibel dengan OpenAI berikut:

https://router.flatkey.ai/v1

Endpoint /v1/models milik Flatkey mengembalikan ID model yang tersedia untuk akun Anda dalam format yang kompatibel dengan OpenAI. Dokumentasi penggunaan Flatkey menyebutkan bahwa setiap permintaan dapat ditinjau bersama model yang digunakan, jumlah token input dan output, biaya, stempel waktu, API key, dan status. Itu membuat Akses API DeepSeek Melalui Router yang Kompatibel dengan OpenAI lebih mudah dioperasikan ketika DeepSeek adalah salah satu kandidat di antara beberapa model.

Catatan rute versi router harus dibuat eksplisit:

deepseek_route:
  provider_access_layer: flatkey
  base_url: https://router.flatkey.ai/v1
  api_key_source: FLATKEY_API_KEY
  candidate_models:
    - deepseek-flash
    - deepseek-v4-pro
  verify_before_launch:
    - account_accessible_v1_models
    - live_model_directory
    - pricing_page_units
    - usage_log_readback
    - fallback_or_rollback_policy

Jangan sembunyikan nama model sebagai string di kode aplikasi. Letakkan di file konfigurasi atau manifest model agar pembaruan model DeepSeek menjadi perubahan yang dapat ditinjau, bukan deployment darurat.

Langkah 1: Pilih DeepSeek Langsung atau Router

Mulailah dengan keputusan operasional, bukan SDK.

Pertanyaan	DeepSeek langsung biasanya cukup ketika...	Router biasanya lebih baik ketika...
Apakah Anda hanya memanggil DeepSeek?	Ya, produknya hanya DeepSeek.	Tidak, DeepSeek adalah satu rute di samping penyedia lain.
Apakah Anda memerlukan kontrol khusus penyedia?	Ya, tim Anda menginginkan pengaturan native DeepSeek dan peninjauan penagihan.	Tidak, aplikasi Anda menginginkan lapisan akses bersama dan log bersama.
Apakah pengguna atau job akan berpindah model?	Tidak, satu model tetap sudah cukup.	Ya, beban kerja dapat berpindah antara DeepSeek, Qwen, Gemini, Claude, GPT, atau keluarga model lainnya.
Siapa yang meninjau biaya dan kegagalan?	Satu developer dapat memeriksa akun DeepSeek.	Anda memerlukan satu ledger penggunaan di seluruh key, model, dan environment.
Apa yang terjadi jika rute gagal?	Anda dapat menjeda fitur atau mencoba lagi nanti.	Anda memerlukan kontrol fallback, rollback, atau peluncuran bertahap.

Untuk sebagian besar indie hacker, rilis pertama bisa sederhana. DeepSeek langsung baik untuk prototipe satu model. Akses API DeepSeek Melalui Router yang Kompatibel dengan OpenAI menjadi lebih rapi setelah produk membandingkan model, menjalankan coding agent, melayani pelanggan dengan kebutuhan latensi atau biaya yang berbeda, atau membutuhkan satu tempat untuk men-debug penggunaan token.

Langkah 2: Setel OpenAI Client Flatkey

Jika project Anda sudah menggunakan OpenAI SDK, pengaturan router sebagian besar hanya perubahan base URL dan key.

Python:

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["FLATKEY_API_KEY"],
    base_url="https://router.flatkey.ai/v1",
)

Node.js:

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.FLATKEY_API_KEY,
  baseURL: "https://router.flatkey.ai/v1",
});

Versi DeepSeek langsung menggunakan bentuk klien bergaya OpenAI yang sama, tetapi mengarah ke DeepSeek:

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["DEEPSEEK_API_KEY"],
    base_url="https://api.deepseek.com",
)

Simpan kedua key di variabel lingkungan atau penyimpanan rahasia. Jangan pernah commit FLATKEY_API_KEY, DEEPSEEK_API_KEY, atau override staging ke dalam repositori.

Langkah 3: Verifikasi Model ID Sebelum Permintaan Pertama

Akses API DeepSeek Melalui Router yang Kompatibel dengan OpenAI harus dimulai dengan penemuan model, bukan string model yang disalin.

Untuk Flatkey, minta router memberi tahu Anda model ID mana yang dapat diakses akun Anda:

curl https://router.flatkey.ai/v1/models \
  -H "Authorization: Bearer $FLATKEY_API_KEY"

Lalu konfirmasi kandidat tersebut di direktori model Flatkey yang aktif dan halaman harga. Untuk DeepSeek langsung, konfirmasi nama model di dokumen dan halaman harga DeepSeek. Berdasarkan pemeriksaan sumber ini, dokumen DeepSeek mengarahkan kode baru ke deepseek-flash dan deepseek-v4-pro, sambil memperingatkan bahwa alias V4 Flash lama adalah nama kompatibilitas.

Buat manifest kecil:

models:
  deepseek_default:
    id: deepseek-flash
    route: flatkey
    base_url: https://router.flatkey.ai/v1
    use_for:
      - coding_assistant
      - structured_extraction
      - long_context_review
    owner: product_engineering
    rollback: previous_production_model

Ini adalah catatan review rute DeepSeek. Catatan ini memberi Anda tempat untuk mencatat model ID, pemilik route, use case, dan target rollback sebelum traffic produksi bergantung pada route. Simpan bersama checklist rilis Anda agar Akses API DeepSeek Melalui Router yang Kompatibel dengan OpenAI tetap dapat diaudit setelah peluncuran.

Langkah 4: Buat Chat Completion Pertama

Mulailah dengan permintaan singkat yang deterministik. Ini adalah tes route, bukan benchmark.

response = client.chat.completions.create(
    model="deepseek-flash",
    messages=[
        {"role": "system", "content": "Return concise implementation advice."},
        {"role": "user", "content": "Explain why base_url configuration matters in one sentence."},
    ],
    temperature=0.2,
    max_tokens=120,
)

print(response.choices[0].message.content)

Jika permintaan gagal, periksa dengan urutan berikut:

Pemeriksaan	Apa yang terdeteksi
`base_url`	Campur-aduk direct vs router, `/v1` yang hilang, path penyedia yang salah
Variabel API key	Env var kosong, jenis key salah, key staging di production
ID model	Alias yang sudah usang, akun tidak punya akses, salah ketik
Bentuk endpoint	Ketidaksesuaian antara Chat Completions vs Responses vs Anthropic Messages
Dukungan fitur	Asumsi tentang vision, mode thinking, JSON, tools, atau streaming
Log penggunaan	Permintaan tidak pernah mencapai router, kegagalan penyedia, ketidaksesuaian token/biaya

Urutan ini mencegah kesalahan debugging yang umum: menganggap kegagalan konfigurasi sebagai kegagalan model.

Langkah 5: Uji Fitur yang Benar-Benar Digunakan Aplikasi Anda

Kompatibel dengan OpenAI tidak berarti setiap penyedia, model, atau path router berperilaku identik. Uji fitur yang penting untuk beban kerja Anda.

Fitur	Smoke test	Kondisi lulus
Chat non-streaming	Satu prompt singkat	Pesan yang dapat digunakan kembali beserta data usage
Streaming	Prompt yang sama dengan streaming diaktifkan	Chunk datang berurutan dan UI tertutup dengan bersih
Output JSON	Tugas ekstraksi kecil	Output divalidasi terhadap schema Anda atau jalur perbaikan
Panggilan tool	Satu schema fungsi sederhana	Field tool-call diparse tanpa hack kustom
Konteks panjang	Input panjang yang representatif	Latensi, biaya, dan kualitas tetap dapat diterima
Vision	Prompt gambar hanya saat menggunakan model yang mendukung vision	Permintaan berhasil hanya pada route yang mendukung vision
Penanganan error	ID model tidak valid di staging	Aplikasi mencatat kegagalan route tanpa mengekspos key

Setelah setiap tes Flatkey, buka Usage Logs. Permintaan harus menampilkan model yang diharapkan, jumlah token, status, timestamp, API key, latensi, dan biaya. Jika tidak ada yang muncul, konfirmasi base URL dan key yang benar-benar digunakan permintaan tersebut.

Langkah 6: Normalkan Biaya Berdasarkan Output yang Diterima

Harga token DeepSeek yang dipublikasikan memang terlihat menarik, tetapi harga token hanyalah satu bagian dari biaya produksi. Bandingkan berdasarkan output yang diterima.

Gunakan worksheet ini:

Metrik	Mengapa penting
Token input	Prompt konteks panjang dapat mendominasi biaya.
Token output	Tugas agen dan coding dapat menghasilkan respons yang jauh lebih panjang daripada tugas chat.
Perilaku cache	Input cache-hit dan cache-miss dapat dihargai berbeda.
Tingkat retry	Route yang murah menjadi mahal ketika membutuhkan retry berulang.
Tingkat penolakan	JSON yang tidak valid, tool-call yang lemah, atau jawaban berkualitas rendah harus dihitung sebagai beban route.
Penggunaan fallback	Lalu lintas fallback harus terlihat, bukan dianggap sebagai kesalahan pembulatan.
Waktu perbaikan manual	Pembersihan manual adalah bagian dari biaya produk nyata.

Rumus praktisnya:

accepted_output_cost =
  (successful_request_cost + retry_cost + fallback_cost + human_repair_cost)
  / accepted_outputs

Gunakan halaman harga langsung DeepSeek untuk unit provider langsung. Gunakan halaman harga langsung Flatkey dan Usage Logs Anda untuk biaya jalur router. Jangan menyalin baris harga statis ke dokumentasi aplikasi tanpa tanggal pengecekan dan penanggung jawab pembaruan.

Langkah 7: Tambahkan Kebijakan Rollback

Akses API DeepSeek Melalui Router yang Kompatibel dengan OpenAI harus dapat dibatalkan sebelum pengguna bergantung padanya.

deepseek_rollout:
  environment: production
  default_model: deepseek-flash
  route: flatkey
  start_percentage: 10
  increase_when:
    - accepted_output_rate >= 0.95
    - p95_latency_ms <= 4500
    - error_rate <= 0.02
    - usage_log_present: true
    - accepted_output_cost_within_budget: true
  rollback_when:
    - error_rate > 0.05
    - schema_failures_above_threshold: true
    - usage_log_missing: true
    - unexpected_cost_spike: true
  rollback_action:
    set_model: previous_production_model
    notify: engineering_owner

Kebijakan ini tidak memerlukan tim platform. Yang diperlukan adalah pemilik rute, satu manifest model, satu kebiasaan peninjauan penggunaan, dan satu pengujian staging sebelum Anda menaikkan trafik.

Di Mana Ini Cocok dalam Flatkey

Flatkey cocok ketika DeepSeek menjadi bagian dari alur kerja perutean model yang lebih luas:

Anda sudah menggunakan SDK yang kompatibel dengan OpenAI dan menginginkan satu base URL untuk beberapa keluarga model.
Anda memerlukan kunci atau kuota terpisah untuk pengembangan, staging, produksi, atau agen coding.
Anda ingin DeepSeek, Qwen, Gemini, Claude, GPT, dan model lain ditinjau melalui satu katalog model dan alur kerja penggunaan.
Anda memerlukan jalur rollback ketika ID model, unit harga, fitur, atau rute provider berubah.

Mulailah dengan quickstart API Flatkey, gunakan panduan migrasi alternatif OpenAI API jika Anda menggantikan panggilan provider langsung, dan pasangkan checklist ini dengan pemeriksaan perutean API DeepSeek vs Qwen ketika beban kerja yang sensitif terhadap biaya membandingkan provider regional.

Untuk keputusan produksi, periksa direktori model Flatkey, halaman harga, dan halaman status yang live. Untuk perilaku model DeepSeek dan harga provider langsung, periksa dokumentasi API DeepSeek dan halaman harga pada hari Anda merilis.

Checklist Akhir untuk Akses API DeepSeek Melalui Router yang Kompatibel dengan OpenAI

Sebelum merilis akses API DeepSeek ke pengguna, konfirmasikan:

ID model saat ini tercantum di dokumen DeepSeek dan dalam daftar model yang dapat diakses di akun Flatkey.
Pengujian DeepSeek langsung menggunakan https://api.deepseek.com dan kunci API DeepSeek.
Pengujian router Flatkey menggunakan https://router.flatkey.ai/v1 dan kunci API Flatkey.
Anda tidak menggunakan deepseek-v4-flash atau deepseek-v4-flash-vision-exp sebagai nama model produksi baru.
Chat, streaming, output JSON, pemanggilan alat, konteks panjang, dan vision diuji secara terpisah saat aplikasi Anda membutuhkannya.
Log Penggunaan menampilkan ID model yang diharapkan, status, jumlah token, timestamp, latensi, kunci API, dan biaya.
Biaya dinormalisasi berdasarkan output yang diterima, bukan hanya tarif token utama.
Rollback adalah perubahan konfigurasi, bukan penulisan ulang kode darurat.
Kunci penyedia disimpan dalam variabel lingkungan atau penyimpanan rahasia, bukan di dalam kode.

Akses API DeepSeek Melalui Router yang Kompatibel dengan OpenAI adalah pola integrasi sederhana ketika rutenya eksplisit. Gunakan DeepSeek langsung ketika Anda hanya membutuhkan DeepSeek. Gunakan Flatkey ketika DeepSeek menjadi bagian dari produk multi-model yang membutuhkan satu client, satu URL dasar, satu loop penggunaan, dan jalur rollback yang bersih.

Pertanyaan yang Sering Diajukan

Apakah DeepSeek mendukung API OpenAI?

Dokumentasi DeepSeek saat ini menyebutkan bahwa API DeepSeek menggunakan format API yang kompatibel dengan OpenAI dan Anthropic. URL dasar format OpenAI adalah https://api.deepseek.com.

Apa URL dasar Flatkey untuk akses API DeepSeek?

Gunakan https://router.flatkey.ai/v1 untuk API Flatkey yang kompatibel dengan OpenAI. Lalu pilih ID model DeepSeek terbaru dari respons /v1/models yang dapat diakses di akun Anda dan direktori model Flatkey yang aktif.

Bisakah saya menggunakan SDK OpenAI yang sama untuk DeepSeek melalui Flatkey?

Ya. Konfigurasikan SDK OpenAI dengan kunci API Flatkey dan https://router.flatkey.ai/v1 sebagai URL dasar. Permintaan tetap menggunakan bentuk Chat Completions yang familiar untuk model yang kompatibel.

Nama model DeepSeek mana yang harus digunakan kode baru?

Periksa dokumen DeepSeek yang aktif sebelum rilis. Pada pengecekan sumber ini, DeepSeek mencantumkan deepseek-flash dan deepseek-v4-pro; disebutkan bahwa nama Flash V4 yang lebih lama diterima demi kompatibilitas tetapi dilayani oleh DeepSeek-V4.1-Flash.

Haruskah saya memublikasikan harga DeepSeek yang tepat di dokumentasi aplikasi saya sendiri?

Hanya jika Anda menyertakan tanggal pengecekan dan penanggung jawab pembaruan. Halaman harga DeepSeek menggunakan tarif token puncak dan di luar jam puncak, dan ketersediaan rute Flatkey atau unit harga harus diverifikasi pada halaman harga dan model Flatkey yang aktif.