M MeyKeyDocumentation
Navigasi Dokumentasi

Jangan pernah menaruh API key, bot token, atau provider secret di dokumentasi publik.

MEYKEY DOCS

Dokumentasi MeyKey

Panduan resmi untuk memakai API MeyKey: generate gambar, chat completions, integrasi coding agent seperti OpenCode, dan otomasi lewat Make.

Endpoint/v1/images/generations
Output automationdata[0].url
Download hasilHTTP GET / Download a file
URL lifetimenever atau detik
Flow yang sudah diuji: Generate → URL MeyKey → HTTP Download a file → binary image.
A · API

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.

B · OPENCODE

OpenCode

OpenCode adalah coding agent di terminal yang mendukung provider [OI]-compatible. MeyKey bisa dipakai langsung sebagai provider-nya.

Sudah diuji: OpenCode 1.19.3 dengan model MeyKey menjalankan tool read, edit, dan bash dengan benar. Tool calling berfungsi pada mode streaming maupun non-streaming.
  1. Pasang OpenCode

    npm i -g opencode-ai

    Pastikan Node.js 18 atau lebih baru. Cek dengan opencode --version.

  2. Buat file config

    Letak file config global:

    Linux / macOS~/.config/opencode/opencode.json
    Windows%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 }
            }
          }
        }
      }
    }
  3. Jalankan

    opencode

    Di dalam aplikasi, buka /models lalu 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:

Lewat env var"apiKey": "{env:MEYKEY_API_KEY}"
Lewat file terpisah"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

baseURL tanpa /v1

Alamat harus https://meykey.site/v1, tanpa garis miring di akhir. Tanpa /v1 koneksi akan gagal.

Paket npm salah

Gunakan @ai-sdk/openai-compatible. Jangan @ai-sdk/openai, karena paket itu memakai jalur /v1/responses dan tool calling tidak berjalan.

Model tidak didaftarkan

Setiap model harus ditulis di dalam models. Model yang tidak terdaftar dianggap tidak ada, walaupun MeyKey menyediakannya.

Provider id tidak cocok

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.

Satu tugas agent bisa menjadi beberapa request berbayar. Pantau pemakaian di halaman Penggunaan API.

Error umum

401 Unauthorized

API key salah atau sudah dicabut. Buat key baru di halaman API Key.

402 Payment Required

Saldo tidak cukup. Lakukan deposit terlebih dahulu.

404 model_not_found

Nama model tidak sama dengan yang tersedia di MeyKey, atau belum didaftarkan pada models di config OpenCode.

Koneksi gagal

Periksa baseURL (harus berakhir /v1) dan pastikan tidak ada proxy yang memblokir.

B · MAKE

Template Make.com

Workflow minimal terdiri dari dua module HTTP.

HTTP 1POST /v1/images/generations
→
HTTP 2Download a file

Module 1 — HTTP · Make a request

URLhttps://meykey.site/v1/images/generations
MethodPOST
Content-Typeapplication/json
Parse responseYes
{
  "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
Jangan ketik 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 JSON

Reference JSON adalah acuan setting/mapping, bukan blueprint Make yang dijamin kompatibel dengan semua versi module Make.

C2 · USER

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

401

API key salah atau Authorization header tidak terkirim.

402

Periksa saldo/billing akun.

image_model_unavailable

Image route/model tidak tersedia pada saat request diproses.

image_payload_unrecognized

Payload upstream tidak berhasil dinormalisasi menjadi gambar. Hindari retry paid request berulang jika upstream mungkin sudah memproses gambar.

Timeout / 5xx

Status dapat ambigu. Cek log/provider sebelum melakukan retry berbayar.