Menggunakan GPT-6 Astra lewat OmniaKey

Tutorial ini memandu Anda dari akun OmniaKey baru hingga permintaan GPT-6 Astra pertama berhasil. Pembahasannya mencakup panggilan API sisi server dan Codex CLI. API key OmniaKey bukan langganan ChatGPT dan tidak dapat dimasukkan ke situs ChatGPT.

Panduan Astra terbaru dari OpenAI dimulai dengan Responses API. Chat Completions tetap tersedia untuk teks biasa, tetapi pemanggilan tool Astra membutuhkan Responses. Contoh berikut mempertahankan batas ini dan membaca key dari environment variable, bukan menaruhnya di source code.

Sebelum memulai

Buat API key dengan cakupan terbatas

Masuk ke OmniaKey dan buka halaman API key. Buat key khusus untuk integrasi ini, lalu tetapkan kuota dan masa berlaku yang sesuai dengan pengujian. Salin key saat ditampilkan.

Akun juga harus memiliki saldo yang dapat digunakan. Berhasil membuat key hanya membuktikan credential tersedia, bukan bahwa akun mampu membayar permintaan.

Perlakukan key seperti password. Jangan melakukan commit ke Git, menaruhnya di aplikasi browser, memasukkannya ke tangkapan layar, atau mengirimkannya di chat.

Simpan key dalam environment variable

Di macOS atau Linux:

export OMNIAKEY_API_KEY="your-omniakey-api-key"

Di PowerShell:

$env:OMNIAKEY_API_KEY="your-omniakey-api-key"

Contoh SDK dan Codex berikut membaca variable yang sama.

Kirim permintaan Responses API pertama

Jalankan permintaan ini di terminal:

curl https://api.omniakey.com/v1/responses \
  -H "Authorization: Bearer $OMNIAKEY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-6-astra",
    "reasoning": {"effort": "medium"},
    "input": "Tinjau rencana migrasi ini. Berikan dua risiko terbesar dan satu pengujian penerimaan untuk masing-masing risiko."
  }'

Respons yang berhasil memuat array output, teks yang dihasilkan, dan penggunaan token. Panggilan pertama ini sekaligus memverifikasi Base URL, key, saldo, izin model, ID model, dan rute Responses.

Setelah berhasil, buka dashboard penggunaan dan pastikan model yang tercatat adalah gpt-6-astra. Tinjau penggunaan input, cached input, reasoning, dan output yang sebenarnya, alih-alih memperkirakan biaya dari teks yang terlihat saja.

Panggil Astra dari Python

Instal atau perbarui SDK Python resmi dari OpenAI:

python -m pip install --upgrade openai

Buat astra_example.py:

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["OMNIAKEY_API_KEY"],
    base_url="https://api.omniakey.com/v1",
)

response = client.responses.create(
    model="gpt-6-astra",
    reasoning={"effort": "medium"},
    input="Jelaskan laporan insiden ini, lalu tuliskan tiga pemeriksaan lanjutan yang paling berguna.",
)

print(response.output_text)

Jalankan:

python astra_example.py

response.output_text adalah field praktis dari SDK untuk mengambil teks yang dihasilkan. Simpan respons lengkap jika Anda juga memerlukan penggunaan, status, atau item pemanggilan tool.

Panggil Astra dari Node.js

Instal SDK:

npm install openai

Buat file sisi server seperti astra-example.mjs:

import OpenAI from "openai";

const apiKey = process.env.OMNIAKEY_API_KEY;
if (!apiKey) throw new Error("OMNIAKEY_API_KEY is required");

const client = new OpenAI({
  apiKey,
  baseURL: "https://api.omniakey.com/v1",
});

const response = await client.responses.create({
  model: "gpt-6-astra",
  reasoning: { effort: "medium" },
  input: "Tinjau desain API ini. Temukan dua mode kegagalan dan satu pengujian untuk masing-masing mode.",
});

console.log(response.output_text);

Jalankan dari shell tempat environment variable sudah ditetapkan:

node astra-example.mjs

Jalankan kode ini di server, komputer lokal, atau worker tepercaya. Key yang masuk ke bundle frontend dapat dibaca oleh pengunjung.

Gunakan GPT-6 Astra di Codex CLI

Custom provider Codex menggunakan Responses wire format. Tambahkan konfigurasi berikut ke file pengguna ~/.codex/config.toml:

model = "gpt-6-astra"
model_provider = "omniakey"

[model_providers.omniakey]
name = "OmniaKey"
base_url = "https://api.omniakey.com/v1"
env_key = "OMNIAKEY_API_KEY"
wire_api = "responses"

Jalankan Codex dari shell yang memiliki key:

export OMNIAKEY_API_KEY="your-omniakey-api-key"
codex

Biarkan requires_openai_auth tidak ditetapkan. Referensi konfigurasi resmi Codex mendefinisikannya sebagai flag autentikasi OpenAI; custom provider ini menggunakan env_key untuk autentikasi.

Periksa dulu model yang ditampilkan Codex, lalu jalankan tugas kecil yang hanya membaca sebelum mengizinkan perubahan. Jika cURL langsung berhasil tetapi Codex gagal, periksa konfigurasi client terlebih dahulu.

Gunakan Chat Completions hanya jika client memerlukannya

GPT-6 Astra juga menerima teks biasa melalui Chat Completions. Gunakan rute ini jika client belum mendukung Responses:

curl https://api.omniakey.com/v1/chat/completions \
  -H "Authorization: Bearer $OMNIAKEY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-6-astra",
    "reasoning_effort": "medium",
    "messages": [
      {"role": "user", "content": "Rangkum dua risiko utama dalam rencana peluncuran ini."}
    ]
  }'

Perhatikan perbedaan parameter: Responses menggunakan reasoning.effort, sedangkan Chat Completions menggunakan reasoning_effort. Jangan menambahkan tool Astra ke contoh Chat Completions ini. Panduan OpenAI saat ini mengharuskan Responses untuk pemanggilan tool Astra.

Pilih reasoning effort

Astra mendukung low, medium, high, xhigh, dan max, tetapi tidak mendukung none. Effort yang lebih tinggi dapat menambah pekerjaan reasoning, latensi, dan biaya token output tanpa menjamin jawaban benar. Gunakan nilai terendah yang lulus pengujian penerimaan Anda.

Berikan tugas yang dapat diverifikasi kepada Astra

Prompt pertama yang baik menyebutkan tujuan, konteks relevan, batasan, dan pemeriksaan penyelesaian:

Tujuan: tinjau risiko deployment untuk migrasi database ini.
Konteks: PostgreSQL 15, satu writer di production, rollback harus selesai dalam lima menit.
Batasan: jangan usulkan perintah destruktif; pisahkan fakta terverifikasi dari asumsi.
Selesai ketika: berikan tiga risiko terbesar, satu mitigasi, dan satu pengujian penerimaan untuk masing-masing risiko.

Untuk pekerjaan coding, sebutkan juga aturan repositori dan perintah tepat yang membuktikan penyelesaian. Astra mengikuti file instruksi yang dapat diakses dengan cermat, jadi tinjau AGENTS.md, skills, dan file sejenis sebelum memberikan akses tool.

Perbaiki error penyiapan yang umum

401, unauthorized, atau API key tidak valid

Pastikan OMNIAKEY_API_KEY ditetapkan di shell yang sama dengan tempat perintah dijalankan. Environment variable hanya berisi key; Bearer hanya berada di HTTP header. Pastikan juga key aktif dan belum kedaluwarsa.

Saldo atau kuota tidak cukup

Periksa saldo akun dan kuota milik key. Akun yang memiliki saldo tetap dapat gagal jika key terbatas sudah mencapai batasnya.

Model tidak ditemukan atau tidak tersedia

Gunakan ID persis gpt-6-astra. Buka halaman model saat ini dan pastikan key diizinkan menggunakan model tersebut. Display name seperti GPT 6 bukan ID API.

Parameter tidak didukung

Hapus temperature, top_p, dan top_logprobs. Pada Chat Completions, hapus juga logprobs; dari include Responses, hapus message.output_text.logprobs. Astra tidak mendukung parameter tersebut.

Respons incomplete atau tidak ada teks yang terlihat

Naikkan max_output_tokens dan periksa output_tokens_details.reasoning_tokens. Token reasoning menggunakan anggaran output sebelum jawaban yang terlihat selesai.

Chat berhasil, tetapi tool gagal

Pindahkan workflow ke /v1/responses. Mulai dengan panggilan Responses teks biasa, lalu tambahkan satu tool setiap kali dan periksa permintaan, hasil, timeout, serta jalur izin. Daftar tool resmi OpenAI menjelaskan kemampuan langsung model; gateway atau client dapat menyediakan cakupan lebih sempit.

Codex tetap menggunakan model lain

Periksa model, model_provider, base_url, env_key, dan wire_api di konfigurasi Codex yang aktif. Setelah itu, mulai ulang Codex dari shell yang memiliki OMNIAKEY_API_KEY.

Verifikasi biaya sebelum production

Jalankan satu tugas representatif, pastikan catatan penggunaan, lalu masukkan pengulangan ke biaya lengkap. Halaman model Astra memuat harga OmniaKey saat ini. Ulasan Astra memisahkan harga gateway dari tarif langsung OpenAI dan menjelaskan batas 272K pada tarif langsung tersebut.

Jika pekerjaan terhenti karena limit, panduan limit Codex menjelaskan cara cek reset dan membandingkan kredit tambahan, perubahan paket, serta API lokal dengan tagihan terpisah.

Referensi

Semua sumber resmi OpenAI berikut berbahasa Inggris. Tautan dokumentasi OmniaKey saat ini juga menuju halaman bahasa Inggris.

• OpenAI: model GPT-6 Astra
• OpenAI: panduan penggunaan GPT-6 Astra
• OpenAI: referensi konfigurasi Codex
• Mulai cepat API OmniaKey (bahasa Inggris)
• API kompatibel OpenAI dari OmniaKey (bahasa Inggris)
• Panduan Codex CLI OmniaKey (bahasa Inggris)