Navigasi Dokumentasi
Jangan pernah menaruh API key, bot token, atau provider secret di dokumentasi publik.
Dokumentasi MeyKey
Panduan resmi untuk memakai API MeyKey: generate gambar, chat completions, integrasi coding agent seperti OpenCode, dan otomasi lewat Make.
Image Generation API
Gunakan endpoint OpenAI-compatible berikut:
POST https://meykey.site/v1/images/generations
Header
Authorization: Bearer YOUR_MEYKEY_API_KEY
Content-Type: application/json
Request minimal yang direkomendasikan
{
"model": "custom_router",
"prompt": "Buat gambar pemandangan alam yang indah.",
"response_format": "url"
}
Response sukses
{
"created": 1790076126,
"data": [
{
"url": "https://meykey.site/artifacts/ARTIFACT_ID?exp=never&sig=SIGNATURE"
}
],
"usage": {},
"meykey": {}
}
Untuk automation, field terpenting adalah data[0].url. URL tersebut adalah URL MeyKey, bukan URL Telegram langsung.
cURL
curl -sS -X POST \
"https://meykey.site/v1/images/generations" \
-H "Authorization: Bearer YOUR_MEYKEY_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "custom_router",
"prompt": "Buat gambar uji sederhana.",
"response_format": "url"
}'
Parameter tambahan
size, quality, dan n bergantung pada model/provider di belakang route. Untuk kompatibilitas tertinggi, mulai dari body minimal dan tambahkan parameter hanya setelah route terkait diuji.
OpenCode
OpenCode adalah coding agent di terminal yang mendukung provider [OI]-compatible. MeyKey bisa dipakai langsung sebagai provider-nya.
read, edit, dan bash dengan benar. Tool calling berfungsi pada mode streaming maupun non-streaming.-
Pasang OpenCode
npm i -g opencode-aiPastikan Node.js 18 atau lebih baru. Cek dengan
opencode --version. -
Buat file config
Letak file config global:
Linux / macOS~/.config/opencode/opencode.jsonWindows%USERPROFILE%\.config\opencode\opencode.json{ "$schema": "https://opencode.ai/config.json", "model": "meykey/kimi-k2-7-code", "small_model": "meykey/deepseek-v4-1-flash", "provider": { "meykey": { "npm": "@ai-sdk/openai-compatible", "name": "MeyKey", "options": { "baseURL": "https://meykey.site/v1", "apiKey": "YOUR_MEYKEY_API_KEY" }, "models": { "kimi-k2-7-code": { "name": "Kimi K2.7 Code", "limit": { "context": 256000, "output": 32768 } }, "deepseek-v4-1-flash": { "name": "DeepSeek V4.1 Flash", "limit": { "context": 128000, "output": 32768 } }, "deepseek-v4-pro": { "name": "DeepSeek V4 Pro", "limit": { "context": 128000, "output": 32768 } }, "glm-5-3": { "name": "GLM 5.3", "limit": { "context": 128000, "output": 32768 } }, "qwen3-8-max": { "name": "Qwen3 8 Max", "limit": { "context": 128000, "output": 32768 } } } } } } -
Jalankan
opencodeDi dalam aplikasi, buka
/modelslalu pilih model MeyKey. Untuk tugas sekali jalan:opencode run 'Jelaskan isi README di repo ini'
Menyimpan API key dengan lebih aman
Menaruh key langsung di config berarti key tersimpan sebagai teks biasa. Dua alternatif yang juga sudah diuji:
"apiKey": "{env:MEYKEY_API_KEY}""apiKey": "{file:~/.secrets/meykey-key}"Bisa juga memakai perintah /connect di dalam OpenCode, lalu pilih Other dan masukkan meykey sebagai provider id. Key akan tersimpan di kredensial OpenCode, bukan di config.
Empat kesalahan yang paling sering terjadi
Alamat harus https://meykey.site/v1, tanpa garis miring di akhir. Tanpa /v1 koneksi akan gagal.
Gunakan @ai-sdk/openai-compatible. Jangan @ai-sdk/openai, karena paket itu memakai jalur /v1/responses dan tool calling tidak berjalan.
Setiap model harus ditulis di dalam models. Model yang tidak terdaftar dianggap tidak ada, walaupun MeyKey menyediakannya.
Nama provider di config harus sama dengan awalan pada model. Contoh: provider meykey dipakai sebagai meykey/kimi-k2-7-code.
Perkiraan biaya
Satu tugas kecil (membaca satu file, mengubah, lalu menjalankan perintah) biasanya memakai beberapa request. Pada pengujian, request pertama sekitar 7.400 token input, lalu tiap langkah berikutnya hanya mengirim tambahan kecil dan sisanya terbaca dari cache.
Error umum
API key salah atau sudah dicabut. Buat key baru di halaman API Key.
Saldo tidak cukup. Lakukan deposit terlebih dahulu.
Nama model tidak sama dengan yang tersedia di MeyKey, atau belum didaftarkan pada models di config OpenCode.
Periksa baseURL (harus berakhir /v1) dan pastikan tidak ada proxy yang memblokir.
Template Make.com
Workflow minimal terdiri dari dua module HTTP.
Module 1 — HTTP · Make a request
https://meykey.site/v1/images/generationsPOSTapplication/jsonYes{
"model": "custom_router",
"prompt": "Buat gambar uji sederhana.",
"response_format": "url"
}
Module 2 — HTTP · Download a file
Authentication: No authentication. Pada kolom URL, map output Module 1:
Module 1 → data[] → item 1 → url
data[0].url sebagai teks biasa. Pilih field URL dari mapping output Module 1.Setelah file didownload
Output Module 2 adalah binary file/buffer. File itu dapat langsung diteruskan ke Google Drive Upload a file, Telegram Send a document/photo, Dropbox, OneDrive, atau storage lain.
Download Make Reference JSONReference JSON adalah acuan setting/mapping, bukan blueprint Make yang dijamin kompatibel dengan semua versi module Make.
Panduan User API
Generate
{
"model": "custom_router",
"prompt": "Buat gambar pemandangan pantai saat matahari terbenam.",
"response_format": "url"
}
Ambil hasil
Jika sukses, ambil data[0].url. URL dapat dibuka di browser atau digunakan untuk HTTP GET/Download a file.
Upload ke Google Drive
Setelah HTTP Download a file, map binary data dan file name ke Google Drive → Upload a file.
Kirim ke Telegram
Gunakan Send a photo untuk preview atau Send a document untuk mengirim file sebagai dokumen.
Error umum
API key salah atau Authorization header tidak terkirim.
Periksa saldo/billing akun.
Image route/model tidak tersedia pada saat request diproses.
Payload upstream tidak berhasil dinormalisasi menjadi gambar. Hindari retry paid request berulang jika upstream mungkin sudah memproses gambar.
Status dapat ambigu. Cek log/provider sebelum melakukan retry berbayar.