Visual Studio Code

Bina projek asAi pertama dalam VS Code.

Tutorial ini membina projek Python kecil, menyimpan API key di luar kod sumber, dan menghantar satu request melalui gateway asAi yang serasi dengan OpenAI.

Sebelum mula

• Pasang Visual Studio Code dan versi Python 3 yang disokong.
• Cipta akaun asAi, sahkan email dan tambah kredit prabayar.
• Cipta key asai_sk_... di API keys. Salin sekali dan simpan dengan selamat.

1. Cipta dan buka folder projek

1. Cipta folder kosong bernama asai-vscode.
2. Dalam VS Code, pilih File > Open Folder dan pilih folder tersebut.
3. Pilih Terminal > New Terminal. Jalankan arahan seterusnya dalam terminal ini.

2. Cipta virtual environment

Windows PowerShell:

python -m venv .venv
.\.venv\Scripts\Activate.ps1

macOS or Linux:

python3 -m venv .venv
source .venv/bin/activate

Apabila persekitaran aktif, terminal biasanya bermula dengan (.venv). Dalam VS Code, tekan Ctrl+Shift+P (atau Cmd+Shift+P pada macOS), pilih Python: Select Interpreter, kemudian pilih interpreter dalam .venv.

3. Pasang pustaka client

python -m pip install --upgrade openai python-dotenv

Library rasmi OpenAI Python berfungsi secara langsung kerana asAi menyediakan endpoint Chat Completions yang serasi dengan OpenAI.

4. Simpan key secara setempat

Cipta fail bernama .env di direktori utama projek:

ASAI_API_KEY=asai_sk_...

Gantikan placeholder dengan key sebenar anda. Jangan letak tanda petik atau ruang kosong di sekelilingnya.

Cipta fail kedua bernama .gitignore:

.env
.venv/
__pycache__/

Jangan tampal key sebenar dalam kod Python, screenshot, mesej chat atau Git repository. Jika key terdedah, revoke di API keys dan cipta gantian.

5. Tambah kod Python

Cipta fail asai_test.py dan tampal kod ini:

import os

from dotenv import load_dotenv
from openai import OpenAI

load_dotenv()
api_key = os.getenv("ASAI_API_KEY")
if not api_key:
    raise RuntimeError("ASAI_API_KEY is missing from .env")

client = OpenAI(
    api_key=api_key,
    base_url="https://serveras.click/v1",
)

response = client.chat.completions.create(
    model="asai/gpt-6-sol",
    messages=[
        {"role": "user", "content": "Reply with: asAi connection works"}
    ],
    max_tokens=50,
)

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

Kekalkan /v1 dalam base URL. Model ID mesti sepadan tepat dengan katalog Model semasa.

6. Run dan sahkan

python asai_test.py

Terminal patut mencetak jawapan daripada model. Kemudian buka Logs untuk sahkan request, model, status, penggunaan token dan kredit yang dicaj.

Penyelesaian masalah

• python tidak dijumpai: pasang Python, buka semula VS Code, dan cuba py pada Windows atau python3 pada macOS dan Linux.
• PowerShell sekat pengaktifan: buka terminal Command Prompt dalam VS Code dan jalankan .venv\Scripts\activate.bat, atau pilih interpreter .venv dan gunakan Python tersebut secara terus.
• ASAI_API_KEY is missing: sahkan nama fail tepat .env, terletak bersebelahan asai_test.py, dan anda menjalankan arahan dari folder projek.
• 401: key hilang, tidak sah, atau telah di-revoke. Cipta gantian di bawah API keys.
• 402: baki kredit tidak mencukupi untuk menampung request. Semak Top up.
• 403: sahkan email anda dan pastikan akaun serta key aktif.
• 429: anda telah mencapai had request atau had serentak akaun. Biarkan request semasa selesai, kemudian tunggu dan cuba lagi.
• 400 model tidak disokong: salin model ID yang tersedia dari Model.

Balas tepat: ASAI_CLINE_OK. Jangan edit fail atau jalankan arahan.