Cara Pakai Tencent Hy4 lewat API: Kirim Teks, Gambar, dan Hitung Biaya dalam Rupiah

Tencent Hy4 adalah model AI open-weight 770 miliar parameter yang resmi dirilis 4 November 2026 dengan kemampuan baru membaca gambar dan mengoperasikan komputer. Modelnya sudah bisa dipanggil lewat OpenRouter dengan format API ala OpenAI, harganya relatif murah, jadi developer Indonesia bisa langsung mencobanya hari ini.

Panduan ini membahas langkah praktisnya: membuat API key, memastikan ID model, mengirim prompt teks dan gambar, sampai menghitung biaya per permintaan dalam rupiah. Semua contoh kode bisa disalin dan dijalankan.

Apa yang baru di Hy4?

Tencent merilis Hy4 Preview pada akhir Agustus 2026. Versi penuh yang keluar 4 November menambah dua hal yang belum ada di preview: visual understanding (membaca grafik, dokumen, dan beberapa gambar sekaligus) serta computer use (mengoperasikan command line dan antarmuka grafis). Menurut Tencent, pelatihannya juga mencakup perangkat lunak profesional seperti Blender dan CAD.

Aspek	Hy4 (4 Nov 2026)	Catatan
Arsitektur	Mixture-of-Experts, 770B total	Preview: 49B parameter aktif per token
Konteks	±1 juta token	OpenRouter mencantumkan 1.048.576 token
Kemampuan baru	Vision dan computer use	Belum ada di Hy4 Preview
Harga OpenRouter	$0,834 input / $2,501 output per 1 juta token	Sama dengan harga preview
Diskon TokenHub	50% sampai 31 Desember 2026	Tencent Cloud TokenHub
Gratis terbatas	4–15 November 2026	Di WorkBuddy dan CodeBuddy
Bobot model	Dijanjikan "dalam beberapa hari"	Belum ada tanggal pasti

Ada sedikit perbedaan angka harga antar sumber. TechNode dan Apiyi menulis $0,834/$2,501 per juta token (angka di OpenRouter). Rilis pers Tencent menyebut "sekitar" $0,90/$2,70 dan $0,045 untuk input yang di-cache. Untuk tagihan, pegang angka yang tertera di dashboard penyedia yang kamu pakai.

Seberapa kuat Hy4 dibanding pesaingnya?

Semua angka di bawah berasal dari materi Tencent yang dirangkum Apiyi. Tencent menjalankan ulang model pesaing dengan setelannya sendiri, jadi ini bukan uji independen.

• Computer use cukup kompetitif. Di OSWorld 2.1, Hy4 mencetak 78,9, sedikit di bawah Kimi K3.1 Pro (79,6) dan Claude (81,8).
• Agen terminal masih tertinggal. Di Terminal Bench 4.0, Hy4 mendapat 44,4, sementara Kimi K3.1 Pro 66,8.
• Vision baru tahap awal. Di BuddyVQA Atlas, Hy4 mendapat 55,6, sementara Claude 75,3.
• Halusinasi turun. Rilis pers Tencent menyebut tingkat halusinasi turun dari 12,95% (preview) menjadi 7,2%.

Kesimpulannya, Hy4 menarik untuk tugas kantor, analisis dokumen panjang, dan otomasi antarmuka dengan biaya rendah. Untuk agen coding berat di terminal, uji dulu dengan kasusmu sendiri. Kalau ingin pembanding open-weight lain, baca juga ulasan Kimi K3.1 Pro.

Bagaimana alur pemakaiannya?

Kita pakai OpenRouter karena endpoint-nya kompatibel dengan OpenAI Chat Completions, bisa dibayar dengan kartu internasional, dan tidak perlu akun Tencent Cloud. Kalau kamu sudah punya akun TokenHub, ID model di sana adalah hy4 dan kamu bisa memanfaatkan diskon 50%.

Langkah 1: Siapkan API key

Buat akun di OpenRouter, isi saldo, lalu buat API key. Simpan di variabel lingkungan, jangan ditulis langsung di kode.

# Linux / macOS
export OPENROUTER_API_KEY="sk-or-v1-xxxxxxxx"

# Pastikan terbaca (hanya tampilkan 8 karakter awal)
echo "${OPENROUTER_API_KEY:0:8}..."

Langkah 2: Pastikan ID model yang benar

Apiyi menulis ID OpenRouter untuk versi penuh adalah tencent/hy4, sedangkan preview memakai tencent/hy4-preview. Karena katalog bisa berubah, cek langsung dari endpoint daftar model. Endpoint ini publik dan tidak butuh key.

curl -s https://openrouter.ai/api/v1/models \
  | jq -r '.data[] | select(.id | startswith("tencent/hy4"))
           | "\(.id)\tctx=\(.context_length)\tin=\(.pricing.prompt)\tout=\(.pricing.completion)"'

Harga di kolom pricing dinyatakan per token dalam dolar. Kalikan satu juta untuk mendapat harga per juta token. Kalau perintah di atas tidak menampilkan tencent/hy4, pakai ID yang muncul di daftar.

Langkah 3: Kirim prompt teks pertama

curl -s https://openrouter.ai/api/v1/chat/completions \
  -H "Authorization: Bearer $OPENROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "tencent/hy4",
    "messages": [
      {"role": "system", "content": "Jawab dalam bahasa Indonesia yang ringkas."},
      {"role": "user", "content": "Jelaskan beda REST dan GraphQL dalam 3 poin."}
    ],
    "max_tokens": 400
  }' | jq '{jawaban: .choices[0].message.content, usage: .usage}'

Bagian usage berisi prompt_tokens dan completion_tokens. Kita akan memakainya untuk menghitung biaya di langkah 5.

Versi Python dengan SDK OpenAI

Karena formatnya kompatibel, SDK resmi OpenAI cukup diarahkan ke base_url OpenRouter.

# pip install openai
import os
from openai import OpenAI

client = OpenAI(
    base_url="https://openrouter.ai/api/v1",
    api_key=os.environ["OPENROUTER_API_KEY"],
)

stream = client.chat.completions.create(
    model="tencent/hy4",
    messages=[{"role": "user", "content": "Buat checklist deploy aplikasi Node.js ke VPS."}],
    max_tokens=600,
    stream=True,
)

for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)
print()

Bagaimana cara mengirim gambar ke Hy4?

Ini fitur yang paling baru. Gambar dikirim sebagai bagian content bertipe image_url. Untuk file lokal, ubah dulu menjadi data URL base64. Contoh berikut meminta Hy4 membaca grafik penjualan dan mengembalikan ringkasan berbentuk JSON.

import base64, json, os, sys
from openai import OpenAI

client = OpenAI(base_url="https://openrouter.ai/api/v1",
                api_key=os.environ["OPENROUTER_API_KEY"])

path = sys.argv[1]  # contoh: python baca_grafik.py grafik.png
mime = "image/png" if path.endswith(".png") else "image/jpeg"
data_url = f"data:{mime};base64," + base64.b64encode(open(path, "rb").read()).decode()

resp = client.chat.completions.create(
    model="tencent/hy4",
    messages=[{
        "role": "user",
        "content": [
            {"type": "text", "text": (
                "Baca grafik ini. Balas HANYA JSON dengan kunci: "
                "judul, periode, nilai_tertinggi, tren (naik/turun/datar)."
            )},
            {"type": "image_url", "image_url": {"url": data_url}},
        ],
    }],
    max_tokens=500,
)

teks = resp.choices[0].message.content
print(teks)
print("token:", resp.usage.prompt_tokens, "in /", resp.usage.completion_tokens, "out")

Beberapa tips agar hasil vision lebih stabil:

• Kecilkan gambar besar (misalnya lebar 1.600 px) agar token input tidak membengkak.
• Minta format keluaran yang jelas, misalnya JSON, lalu validasi di kodemu. Jangan langsung percaya angka hasil bacaan.
• Untuk dokumen identitas seperti KTP, lebih aman memakai OCR khusus seperti OCR KTP di APIPedia yang hasilnya sudah terstruktur per kolom.

Berapa biayanya dalam rupiah?

Rumusnya sederhana: (prompt_tokens × harga input + completion_tokens × harga output) ÷ 1.000.000. Hasilnya dalam dolar, lalu dikonversi ke rupiah. Untuk kursnya, kita bisa memakai endpoint kurs APIPedia yang mengambil kurs referensi ECB.

// node biaya-hy4.mjs 50000 5000   (Node.js 18+)
const [promptTokens = 50000, completionTokens = 5000] = process.argv.slice(2).map(Number);

const HARGA = { input: 0.834, output: 2.501 }; // USD per 1 juta token (OpenRouter)
const usd = (promptTokens * HARGA.input + completionTokens * HARGA.output) / 1_000_000;

const res = await fetch(
  "https://api.apipedia.id/v1/kurs/convert?from=USD&to=IDR&amount=" + usd,
  { headers: { Authorization: `Bearer ${process.env.APIPEDIA_API_KEY}` } }
);
const { is_success, data, message } = await res.json();
if (!is_success) throw new Error(message);

console.log(`Biaya: $${usd.toFixed(6)} ≈ Rp${Math.round(data.result).toLocaleString("id-ID")}`);
console.log(`Kurs ${data.date}: 1 USD = Rp${data.rate.toLocaleString("id-ID")} (${data.source})`);

Contoh hitungannya dengan kurs ECB 4 November 2026 (1 USD = Rp18.129):

Skenario	Token in / out	Biaya USD	Perkiraan rupiah
Ringkas dokumen panjang	50.000 / 5.000	$0,0542	± Rp983
1 juta token input saja	1.000.000 / 0	$0,834	± Rp15.120
1 juta token output saja	0 / 1.000.000	$2,501	± Rp45.341

Angka di atas belum termasuk diskon cache, biaya platform, atau pajak. Kalau tagihanmu dibayar dengan kartu bank Indonesia, cek juga dampak PPN transaksi digital luar negeri (SPP-TDLN). Panduan lengkap endpoint kurs ada di artikel API kurs rupiah, dan API key-nya bisa dibuat di console APIPedia.

Apa yang perlu diwaspadai?

1. Bobot belum dirilis. Meski disebut open-weight, Tencent baru menjanjikan bobot dan system card "dalam beberapa hari". Untuk sekarang, akses praktisnya lewat API.
2. Benchmark dari vendor. Semua skor berasal dari Tencent. Belum ada uji independen untuk computer use.
3. Data sensitif. Prompt dan gambar melewati OpenRouter dan penyedia inferensi. Jangan kirim data pribadi pelanggan tanpa dasar hukum yang jelas.
4. Kontrol pengeluaran. Konteks 1 juta token itu besar. Set max_tokens dan batas kredit di dashboard agar satu prompt raksasa tidak menguras saldo.
5. Hy4 Flash masih ditunggu. Versi yang lebih hemat dijanjikan segera, tetapi belum ada spesifikasi atau harga.

FAQ

Apakah Hy4 gratis?

Ada kuota gratis terbatas di WorkBuddy dan CodeBuddy pada 4–15 November 2026. Lewat API, Hy4 berbayar per token, dengan diskon 50% di Tencent Cloud TokenHub sampai 31 Desember 2026.

Apakah bisa dijalankan di server sendiri?

Belum. Tencent menyatakan bobot akan dirilis segera, tanpa tanggal pasti. Dengan 770 miliar parameter, menjalankannya sendiri juga butuh klaster GPU besar, jadi API tetap jalur paling realistis bagi kebanyakan tim.

Apakah kode untuk OpenAI bisa langsung dipakai?

Ya, untuk Chat Completions cukup ganti base_url ke https://openrouter.ai/api/v1 dan model ke ID Hy4. Apiyi juga menyebut API Tencent kompatibel dengan format OpenAI Responses dan Anthropic Messages, berdasarkan dokumentasi preview.

Apa beda Hy4 dengan Hy4 Preview?

Hy4 penuh menambah vision dan computer use, serta diklaim lebih baik di tugas penalaran panjang. Harga API-nya sama dengan preview.

Cocok untuk chatbot berbahasa Indonesia?

Tencent tidak merilis benchmark khusus bahasa Indonesia. Uji dengan 20–50 contoh percakapan nyata dari produkmu sebelum memindahkan trafik produksi.

Sumber

• TechNode: Tencent launches Hy4 with vision and computer-use capabilities
• PR Newswire: Tencent Launches Hy4 (rilis pers resmi)
• Apiyi: Hy4 770B, vision, computer use, dan harga
• OpenRouter: halaman model Tencent Hy4 Preview
• TechNode: Tencent says Hy4 and Hy4 flash will support visual understanding
• DEV Community: Tencent's Hy4 can see and use your computer, explained honestly