For the complete documentation index, see llms.txt. This page is also available as Markdown.

Connect OpenAI-compatible Clients to GreenNode MaaS

Guide to configuring tools, SDKs, and IDE extensions that speak the OpenAI API format to call models through a GreenNode endpoint — using either a PAYG API Key or a Token Plan subscription-key.


Prerequisites

  • An AI Platform account

  • A key in ACTIVE status — either an API Key (PAYG) or a subscription-key (Token Plan)

  • A tool/SDK that supports a custom base URL (OpenAI SDK, LiteLLM, Cursor, Continue.dev, etc.)


Pick your configuration by service type

Every tool on this page uses the OpenAI standard → the Base URL includes /v1 on both service types. Only the host and the key type differ:

Service type
Base URL
Key
Model

PAYG

https://maas-llm-aiplatform-hcm.api.vngcloud.vn/v1

API Key from the API Keys page

Model ID from the Models portal (e.g. openai/gpt-4o)

Token Plan

https://tokenplan.api.greennode.ai/v1

subscription-key from Plan Detail → Subscription keys tab

Model code on the plan's Models tab (e.g. glm-5.2)

Every example below has 2 tabs — pick the tab for your service type and copy it as-is, replacing only the key and the model.


Step 1 — Get your key

  1. Log in to the AI Platform Console

  2. Go to API KeysCreate API Key

  3. Name the key (5–50 characters, lowercase letters + numbers + hyphens)

  4. Copy the API key you just created

  1. Go to API KeyToken PlanMy Token Plans and open the plan you bought

  2. Subscription keys tab → copy default-key or a key you created

  3. Models tab → copy the Model code of the model you want

No plan yet? See Buy Token Plan.


Step 2 — List the available models

Use the id value from the response as the model parameter when calling the API.

Your plan's model list is shown directly on Plan Detail → Models tab — the Model code column is exactly what goes into the model parameter.

A plan can only call the models listed on that tab; anything else returns 403 Forbidden.


Step 3 — Configure your client

OpenAI Python SDK

OpenAI Node.js SDK

Environment variables (for tools/CLIs that read OpenAI-compatible config)

LiteLLM

Cursor / Continue.dev

In the tool's settings, fill in the values for your key's service type:

Field
PAYG
Token Plan

Base URL

https://maas-llm-aiplatform-hcm.api.vngcloud.vn/v1

https://tokenplan.api.greennode.ai/v1

API Key

your PAYG API Key

your subscription-key

Model

openai/gpt-4o, gemini/gemini-2.5-flash, qwen/qwen3-27b (or a model from Step 2)

Model code on the plan's Models tab


Step 4 — Test the connection

Send a test request with curl:

Expected result: a JSON response containing choices[0].message.content.


Billing & Usage

PAYG
Token Plan

Pricing model

Pay per token actually used, 1 credit = 1 VND

Fixed prepaid 30-day package, token/request quota per model

When it runs out

Prepaid: credit is deducted every 5-minute collection cycle — when credit hits zero, the model is auto-disabled. Postpaid: usage is billed on account, no quota cap

Once that model's token quota is exhausted, requests stop — wait for the next cycle, buy another plan, or temporarily switch to a PAYG API Key

Where to track

AI Platform ConsoleUsage and Cost tabs

AI Platform ConsoleUsage tab only (cost was fixed at purchase)


Troubleshooting

Symptom
Cause
Fix

401 Unauthorized

Wrong or not-yet-ACTIVE key

Re-check the key and its status

401 while the key is still valid

Key and Base URL belong to different service types

Re-check the table at the top: a key from the API Keys page → the maas-llm-… host; a key from the Subscription keys tab → the tokenplan… host

403 Forbidden (Token Plan)

Model isn't included in the plan

Only call models listed on the plan's Models tab

402 Payment Required (Token Plan)

Plan expired or was deleted

Buy the plan again or enable Auto-renew

404 Not Found

Missing /v1 in the URL

OpenAI standard — the base URL must end with /v1

Model doesn't respond

PAYG out of credit, or Token Plan out of token quota

PAYG: top up credit. Token Plan: wait for the next cycle or buy another plan

OPENAI_BASE_URL ignored

The tool overrides it with its own config variable

Check that tool's docs for how to set a custom base URL

Response parse errors

The tool appends /v1 to the base URL itself

Try removing /v1 from the base URL if the tool handles it


Result

Your tool or SDK now calls models through the GreenNode endpoint for your chosen service type instead of OpenAI directly. Usage is recorded in the AI Platform Console.

I want to next...
Go to

Use Claude Code with MaaS

Learn about Token Plan packages

Walk Token Plan end-to-end, from purchase to a running tool

View usage and billing

Last updated