diff --git a/English/SUMMARY.md b/English/SUMMARY.md index 0fe23918..5cab8f65 100644 --- a/English/SUMMARY.md +++ b/English/SUMMARY.md @@ -742,13 +742,10 @@ * [Import Model Registry Using a Custom Container](ai-stack/ai-platform/model-registry/import-model-registry-using-a-custom-container.md) * [Model as a Service (MaaS)](ai-stack/model-as-a-service/README.md) * [Understanding AI Models](ai-stack/model-as-a-service/understanding-ai-models.md) - * [OCR API Usage Guide](ai-stack/model-as-a-service/ocr-api-usage-guide.md) * [Playground](ai-stack/model-as-a-service/playground.md) * [Available Models](ai-stack/model-as-a-service/available-models.md) * [MaaS API](ai-stack/model-as-a-service/maas-api.md) - * [Using MaaS with AI Gateway](ai-stack/model-as-a-service/using-maas-with-ai-gateway.md) * [Pricing](ai-stack/model-as-a-service/pricing.md) - * [Model Pricing List](ai-stack/model-as-a-service/model-pricing-list.md) * [AI Gateway](ai-stack/ai-gateway/README.md) * [What is AI Gateway?](ai-stack/ai-gateway/what-is-ai-gateway.md) * [Get Started with AI Gateway](ai-stack/ai-gateway/get-starting-with-ai-gateway/README.md) diff --git a/English/ai-stack/ai-coding/getting-started.md b/English/ai-stack/ai-coding/getting-started.md index d60a4aed..13e857dd 100644 --- a/English/ai-stack/ai-coding/getting-started.md +++ b/English/ai-stack/ai-coding/getting-started.md @@ -70,7 +70,7 @@ The Model ID for the same model **can differ** between the two service types. Al Model ID used in configuration (PAYG example): **`z-ai/glm-5.2`** {% hint style="info" %} -**GLM 5.2 here is just an example model.** GreenNode self-hosts **many models** — swap in whichever model you want to use. On PAYG, the exact **Model ID** and **Base URL** for each model are on that model's **detail page** in the [Models portal](https://aiplatform.console.greennode.ai/models). On Token Plan, check your purchased plan's **Models** tab. +**GLM 5.2 here is just an example model.** GreenNode MaaS offers **many models** — swap in whichever model you want to use. On PAYG, the exact **Model ID** and **Base URL** for each model are on that model's **detail page** in the [Models portal](https://aiplatform.console.greennode.ai/models). On Token Plan, check your purchased plan's **Models** tab. {% endhint %} --- diff --git a/English/ai-stack/model-as-a-service/available-models.md b/English/ai-stack/model-as-a-service/available-models.md index 69822427..9f5a8b30 100644 --- a/English/ai-stack/model-as-a-service/available-models.md +++ b/English/ai-stack/model-as-a-service/available-models.md @@ -1,41 +1,46 @@ # Available Models -The MaaS API provides full-accuracy access to model families such as Gemini, Anthropic, OpenAI, and others listed below. +The MaaS API provides full-accuracy access to model families such as Anthropic, OpenAI, Qwen, and others listed below. {% hint style="info" %} -The model catalog below has been updated under the transition starting **August 3, 2026**, covering models self-hosted by GreenNode and third-party models under official contracts. See the timeline details in [Release Notes](../release-notes.md) and the full price list in [Model Pricing List](model-pricing-list.md). +The model catalog below has been updated under the transition starting **August 3, 2026**, covering models self-hosted by GreenNode and third-party models under official contracts. See the timeline details in [Release Notes](../release-notes.md) and the billing rules in [Pricing](pricing.md). {% endhint %} -### Danh sách mô hình - -MaaS hỗ trợ nhiều loại mô hình khác nhau: - -#### _**Chat**_ - -| Model Name | Provider | Modalities (Input → Output) | Rate Limit | Available From | -| --------------- | ----------- | ----------------------------------- | ---------- | ------------------ | -| Kimi K2.7 Code | Moonshot AI | Text + Image → Text | – | August 3, 2026 | -| Kimi 2.6 | Moonshot AI | Text + Image → Text | – | August 3, 2026 | -| GLM-5.2 | Zhipu AI | Text → Text | – | August 3, 2026 | -| Gemma 4 31B-IT | Google | Text + Image → Text | – | August 3, 2026 | -| Qwen 3.7 Plus | Qwen | Text + Image + Video → Text | – | August 3, 2026 | -| Qwen 3.6 Plus | Qwen | Text + Image + Video → Text | – | August 3, 2026 | -| Qwen 3.6 Flash | Qwen | Text + Image + Video → Text | – | August 3, 2026 | -| MiniMax M3 | MiniMax | Text + Image + Video → Text | – | August 3, 2026 | -| MiniMax M2.5 | MiniMax | Text → Text | – | August 3, 2026 | -| Opus 4.8 | Anthropic | Text + Image + File → Text | – | August 20, 2026 | -| Sonnet 4.6 | Anthropic | Text + Image + File → Text | – | August 20, 2026 | -| Haiku 4.5 | Anthropic | Text + Image + File → Text | – | August 20, 2026 | -| GPT-5.4 | OpenAI | Text + Image + File → Text | – | August 20, 2026 | -| GPT-5.4 Mini | OpenAI | Text + Image + File → Text | – | August 20, 2026 | -| GPT-5.4 Nano | OpenAI | Text + Image + File → Text | – | August 20, 2026 | -| GPT-5 | OpenAI | Text + Image + File → Text | – | August 20, 2026 | -| GPT-5 Mini | OpenAI | Text + Image + File → Text | – | August 20, 2026 | -| GPT-5 Nano | OpenAI | Text + Image + File → Text | – | August 20, 2026 | -| GPT-4o | OpenAI | Text + Image + File → Text | – | August 20, 2026 | -| GPT-4o Mini | OpenAI | Text + Image + File → Text | – | August 20, 2026 | -| GPT-OSS 20B | OpenAI | Text → Text | – | August 20, 2026 | -| GPT-OSS 120B | OpenAI | Text → Text | – | August 20, 2026 | +### Model list + +The **Provider Type** column tells you where your request is processed: + +* **GreenNode self-host** — the model runs on GreenNode infrastructure. +* **Third-party** — the request is forwarded to the model vendor (Anthropic, OpenAI, Moonshot AI, Qwen, MiniMax, Cohere, etc.) under an official contract. + +MaaS supports several model types: + +#### _Chat_ + +| Model Name | Provider Type | Modalities (Input → Output) | Rate Limit | Available From | +| --------------- | ------------------- | ----------------------------------- | ---------- | ------------------ | +| Kimi K2.7 Code | Third-party | Text + Image → Text | – | August 3, 2026 | +| Kimi 2.6 | Third-party | Text + Image → Text | – | August 3, 2026 | +| GLM-5.2 | GreenNode self-host | Text → Text | – | August 3, 2026 | +| Gemma 4 31B-IT | Third-party | Text + Image → Text | – | August 3, 2026 | +| Qwen 3.7 Plus | Third-party | Text + Image + Video → Text | – | August 3, 2026 | +| Qwen 3.6 Plus | Third-party | Text + Image + Video → Text | – | August 3, 2026 | +| Qwen 3.6 Flash | Third-party | Text + Image + Video → Text | – | August 3, 2026 | +| MiniMax M3 | Third-party | Text + Image + Video → Text | – | August 3, 2026 | +| MiniMax M2.5 | Third-party | Text → Text | – | August 3, 2026 | +| Opus 4.8 | Third-party | Text + Image + File → Text | – | August 20, 2026 | +| Sonnet 4.6 | Third-party | Text + Image + File → Text | – | August 20, 2026 | +| Haiku 4.5 | Third-party | Text + Image + File → Text | – | August 20, 2026 | +| GPT-5.4 | Third-party | Text + Image + File → Text | – | August 20, 2026 | +| GPT-5.4 Mini | Third-party | Text + Image + File → Text | – | August 20, 2026 | +| GPT-5.4 Nano | Third-party | Text + Image + File → Text | – | August 20, 2026 | +| GPT-5 | Third-party | Text + Image + File → Text | – | August 20, 2026 | +| GPT-5 Mini | Third-party | Text + Image + File → Text | – | August 20, 2026 | +| GPT-5 Nano | Third-party | Text + Image + File → Text | – | August 20, 2026 | +| GPT-4o | Third-party | Text + Image + File → Text | – | August 20, 2026 | +| GPT-4o Mini | Third-party | Text + Image + File → Text | – | August 20, 2026 | +| GPT-OSS 20B | Third-party | Text → Text | – | August 20, 2026 | +| GPT-OSS 120B | Third-party | Text → Text | – | August 20, 2026 | {% hint style="info" %} Modalities describe the model's general capability per its provider's documentation — actual support may depend on the specific API endpoint used via MaaS. Models listed as **August 3, 2026** are live now; models listed as **August 20, 2026** are rolling out progressively and are not yet available. @@ -43,22 +48,22 @@ Modalities describe the model's general capability per its provider's documentat #### _Image Generation_ -| Model Name | Provider | Modalities (Input → Output) | Rate Limit | Available From | -| -------------- | -------- | ------------------------------- | ---------- | --------------- | -| gpt-image-2 | OpenAI | Text + Image → Image | – | August 20, 2026 | +| Model Name | Provider Type | Modalities (Input → Output) | Rate Limit | Available From | +| -------------- | ------------- | ------------------------------- | ---------- | --------------- | +| gpt-image-2 | Third-party | Text + Image → Image | – | August 20, 2026 | #### _Embedding_ -| Model Name | Provider | Modalities (Input → Output) | Rate Limit | Available From | -| -------------------- | -------- | ------------------------------- | ---------- | --------------- | -| Cohere Embed v4 | Cohere | Text + Image → Vector | – | August 20, 2026 | -| Qwen3 Embedding 8B | Qwen | Text → Vector | – | August 20, 2026 | +| Model Name | Provider Type | Modalities (Input → Output) | Rate Limit | Available From | +| -------------------- | ------------------- | ------------------------------- | ---------- | --------------- | +| Cohere Embed v4 | Third-party | Text + Image → Vector | – | August 20, 2026 | +| Qwen3 Embedding 8B | Third-party | Text → Vector | – | August 20, 2026 | #### _Rerank_ -| Model Name | Provider | Modalities (Input → Output) | Rate Limit | Available From | -| ------------------------ | -------- | ------------------------------- | ---------- | --------------- | -| Cohere Rerank v4.0 pro | Cohere | Text → Ranked List | – | August 20, 2026 | +| Model Name | Provider Type | Modalities (Input → Output) | Rate Limit | Available From | +| ------------------------ | ------------- | ------------------------------- | ---------- | --------------- | +| Cohere Rerank v4.0 pro | Third-party | Text → Ranked List | – | August 20, 2026 | Note: diff --git a/English/ai-stack/model-as-a-service/maas-api.md b/English/ai-stack/model-as-a-service/maas-api.md index 44ebaf8a..310c014a 100644 --- a/English/ai-stack/model-as-a-service/maas-api.md +++ b/English/ai-stack/model-as-a-service/maas-api.md @@ -2,6 +2,8 @@ **MaaS** provides an **OpenAI-compatible** API for seamless model inference. You can integrate easily using the **Python or JavaScript SDK**, or directly from your **terminal with cURL**. +## 1. OpenAI-compatible API (Chat, Completion, Embedding, Image Generation) + Refer to the scripts under API Usage on the Portal. _Curl_ @@ -15,3 +17,122 @@ _Python_ Javascript
+ +*** + +## 2. OCR API + +OCR is one of the model types available in MaaS. Because it works on documents (file upload, asynchronous processing), it exposes its own set of endpoints instead of the OpenAI-compatible endpoint above. This section explains how to call the OCR API. + +### Submit OCR (upload file to create a request) + +* **Method**: `POST` +* **URL**: `https://maas-llm-aiplatform-hcm.api.vngcloud.vn/maas/user-/greennode/idp/v1/ocr/ingest` +* **Headers**: + * `Authorization: Bearer ` + * `portal-user-id: ` +* **Body**: `multipart/form-data` + * `flow` (required) + * `single`: OCR for a single document + * or ``: OCR for a document workflow (if provided) + * `doc_type` (required if `flow=single`): `` + * `file_type` (required): `PDF` or `IMAGE` + * `file` (required): file to be processed by OCR + +#### Example + +```bash +curl --location 'https://maas-llm-aiplatform-hcm.api.vngcloud.vn/maas/user-/greennode/idp/v1/ocr/ingest' \ + --header 'Authorization: Bearer ' \ + --header 'portal-user-id: ' \ + --form 'flow="single"' \ + --form 'doc_type=""' \ + --form 'file_type="PDF"' \ + --form 'file=@""' +``` + +Response will include: + +* `request_id`: used to retrieve results +* (optional) `file_ids`: used to download result images + +### Get OCR Result (use `request_id` to retrieve text/data) + +* **Method**: `GET` +* **URL**: `https://maas-llm-aiplatform-hcm.api.vngcloud.vn/maas/user-/greennode/idp/v1/ocr/ingest/` +* **Headers**: + * `Authorization: Bearer ` + * `portal-user-id: ` + +#### Example + +```bash +curl --location 'https://maas-llm-aiplatform-hcm.api.vngcloud.vn/maas/user-/greennode/idp/v1/ocr/ingest/' \ + --header 'Authorization: Bearer ' \ + --header 'portal-user-id: ' +``` + +#### What if no data is returned yet? + +This is normal because OCR processing is still in progress. + +* Wait 2–5 seconds and call the API again (polling). +* If the timeout is exceeded and no data is returned, send the request\_id to the support team for investigation. + +### Additional OCR Data APIs (optional, depending on needs) + +#### Get Table Data (TABLE) + +* **Method**: `GET` +* **URL**: `https://maas-llm-aiplatform-hcm.api.vngcloud.vn/maas/user-/greennode/idp/v1/ocr/ingest/table//` + +```bash +curl --location 'https://maas-llm-aiplatform-hcm.api.vngcloud.vn/maas/user-/greennode/idp/v1/ocr/ingest/table//' \ + --header 'Authorization: Bearer ' \ + --header 'portal-user-id: ' +``` + +#### Get Signature Results + +* **Method**: `GET` +* **URL**: `https://maas-llm-aiplatform-hcm.api.vngcloud.vn/maas/user-/greennode/idp/v1/ocr/ingest/signature//` + +```bash +curl --location 'https://maas-llm-aiplatform-hcm.api.vngcloud.vn/maas/user-/greennode/idp/v1/ocr/ingest/signature//' \ + --header 'Authorization: Bearer ' \ + --header 'portal-user-id: ' +``` + +Note: document\_id is included in the response of Get OCR Result. + +#### Get Stamp Results + +* **Method**: `GET` +* **URL**: `https://maas-llm-aiplatform-hcm.api.vngcloud.vn/maas/user-/greennode/idp/v1/ocr/ingest/stamp//` + +```bash +curl --location 'https://maas-llm-aiplatform-hcm.api.vngcloud.vn/maas/user-/greennode/idp/v1/ocr/ingest/stamp//' \ + --header 'Authorization: Bearer ' \ + --header 'portal-user-id: ' +``` + +#### Download Result Images + +* **Method**: `GET` +* **URL**: `https://maas-llm-aiplatform-hcm.api.vngcloud.vn/maas/user-/greennode/idp/v1/ocr/ingest/file//` + +```bash +curl --location 'https://maas-llm-aiplatform-hcm.api.vngcloud.vn/maas/user-/greennode/idp/v1/ocr/ingest/file//' \ + --header 'Authorization: Bearer ' \ + --header 'portal-user-id: ' +``` + +### Quick Troubleshooting for OCR + +* `403 Forbidden`: + * Missing/invalid `Authorization` or permission denied. +* `400 Bad Request` / `4XX`: + * Missing required fields (`flow`, `file_type`, `file`, ...) + * Invalid `doc_type` configuration. +* Polling does not return results: + * Provide `request_id` + timestamp + sample file (if possible) to the support team for further investigation. diff --git a/English/ai-stack/model-as-a-service/ocr-api-usage-guide.md b/English/ai-stack/model-as-a-service/ocr-api-usage-guide.md deleted file mode 100644 index f6ce326a..00000000 --- a/English/ai-stack/model-as-a-service/ocr-api-usage-guide.md +++ /dev/null @@ -1,122 +0,0 @@ -# OCR API Usage Guide - -This document provides instructions on how to use the OCR API. - -### Submit OCR (upload file to create a request) - -* **Method**: `POST` -* **URL**: `https://maas-llm-aiplatform-hcm.api.vngcloud.vn/maas/user-/greennode/idp/v1/ocr/ingest` -* **Headers**: - * `Authorization: Bearer ` - * `portal-user-id: ` -* **Body**: `multipart/form-data` - * `flow` (required) - * `single`: OCR for a single document - * or``: OCR for a document workflow (if provided) - * `doc_type` (required if `flow=single`): `` - * `file_type` (required): `PDF` or `IMAGE` - * `file` (required): file to be processed by OCR - -#### Example - -```bash -curl --location 'https://maas-llm-aiplatform-hcm.api.vngcloud.vn/maas/user-/greennode/idp/v1/ocr/ingest' \ - --header 'Authorization: Bearer ' \ - --header 'portal-user-id: ' \ - --form 'flow="single"' \ - --form 'doc_type=""' \ - --form 'file_type="PDF"' \ - --form 'file=@""' -``` - -Response will include: - -* `request_id`: used to retrieve results -* (optional) `file_ids`: used to download result images - -*** - -### Get OCR Result (use `request_id` to retrieve text/data) - -* **Method**: `GET` -* **URL**: `https://maas-llm-aiplatform-hcm.api.vngcloud.vn/maas/user-/greennode/idp/v1/ocr/ingest/` -* **Headers**: - * `Authorization: Bearer ` - * `portal-user-id: ` - -#### Example - -```bash -curl --location 'https://maas-llm-aiplatform-hcm.api.vngcloud.vn/maas/user-/greennode/idp/v1/ocr/ingest/' \ - --header 'Authorization: Bearer ' \ - --header 'portal-user-id: ' -``` - -#### What if no data is returned yet? - -This is normal because OCR processing is still in progress. - -* Wait 2–5 seconds and call the API again (polling). -* If the timeout is exceeded and no data is returned, send the request\_id to the support team for investigation. - -*** - -### Additional OCR Data APIs (optional, depending on needs) - -### Get Table Data(TABLE) - -* **Method**: `GET` -* **URL**: `https://maas-llm-aiplatform-hcm.api.vngcloud.vn/maas/user-/greennode/idp/v1/ocr/ingest/table//` - -```bash -curl --location 'https://maas-llm-aiplatform-hcm.api.vngcloud.vn/maas/user-/greennode/idp/v1/ocr/ingest/table//' \ - --header 'Authorization: Bearer ' \ - --header 'portal-user-id: ' -``` - -### Get Signature Results - -* **Method**: `GET` -* **URL**: `https://maas-llm-aiplatform-hcm.api.vngcloud.vn/maas/user-/greennode/idp/v1/ocr/ingest/signature//` - -```bash -curl --location 'https://maas-llm-aiplatform-hcm.api.vngcloud.vn/maas/user-/greennode/idp/v1/ocr/ingest/signature//' \ - --header 'Authorization: Bearer ' \ - --header 'portal-user-id: ' -``` - -Note: document\_id is included in the response of Get OCR Result. - -### Get Stamp Results - -* **Method**: `GET` -* **URL**: `https://maas-llm-aiplatform-hcm.api.vngcloud.vn/maas/user-/greennode/idp/v1/ocr/ingest/stamp//` - -```bash -curl --location 'https://maas-llm-aiplatform-hcm.api.vngcloud.vn/maas/user-/greennode/idp/v1/ocr/ingest/stamp//' \ - --header 'Authorization: Bearer ' \ - --header 'portal-user-id: ' -``` - -### Download Result Images - -* **Method**: `GET` -* **URL**: `https://maas-llm-aiplatform-hcm.api.vngcloud.vn/maas/user-/greennode/idp/v1/ocr/ingest/file//` - -```bash -curl --location 'https://maas-llm-aiplatform-hcm.api.vngcloud.vn/maas/user-/greennode/idp/v1/ocr/ingest/file//' \ - --header 'Authorization: Bearer ' \ - --header 'portal-user-id: ' -``` - -*** - -### Quick Troubleshooting - -* `403 Forbidden`: - * Missing/invalid `Authorization` or permission denied. -* `400 Bad Request` / `4XX`: - * Missing required fields (`flow`, `file_type`, `file`, ...) - * Invalid `doc_type` configuration.. -* Polling does not return results: - * Provide `request_id` + timestamp + sample file (if possible) to the support team for further investigation. diff --git a/English/ai-stack/model-as-a-service/pricing.md b/English/ai-stack/model-as-a-service/pricing.md index 750a6b41..fb862517 100644 --- a/English/ai-stack/model-as-a-service/pricing.md +++ b/English/ai-stack/model-as-a-service/pricing.md @@ -10,7 +10,7 @@ description: >- MaaS supports multiple model types, and pricing depends on the type of model used. -See detailed per-model unit prices in [Model Pricing List](model-pricing-list.md). +Per-model unit prices are shown directly on the [AI Platform Portal](https://aiplatform.console.greennode.ai/models). #### Model Classification for Billing diff --git a/English/ai-stack/model-as-a-service/understanding-ai-models.md b/English/ai-stack/model-as-a-service/understanding-ai-models.md index 658238d8..f30078db 100644 --- a/English/ai-stack/model-as-a-service/understanding-ai-models.md +++ b/English/ai-stack/model-as-a-service/understanding-ai-models.md @@ -58,6 +58,6 @@ The more tokens in context (prompt + conversation history), the longer a model t | I want to... | Go to | | ---------------------------------------------- | ------------------------------------------ | | See models grouped by function | [Available Models](available-models.md) | -| See unit prices by model | [Model Pricing List](model-pricing-list.md) | +| See how usage is charged | [Pricing](pricing.md) | | Quickly try a model before integrating | [Playground](playground.md) | | Call a model via API | [MaaS API](maas-api.md) | diff --git a/English/ai-stack/release-notes.md b/English/ai-stack/release-notes.md index 51986b3c..4520e32b 100644 --- a/English/ai-stack/release-notes.md +++ b/English/ai-stack/release-notes.md @@ -22,7 +22,7 @@ GreenNode is updating the MaaS model catalog into two groups — **GreenNode sel * Current models are discontinued & the new catalog goes live on **August 3, 2026**, with an automatic extension until **September 2, 2026** before old-model requests start returning errors. * Compare your current models against the [new catalog](model-as-a-service/available-models.md); only switch if your model is no longer listed. -* See full pricing at [Model Pricing List](model-as-a-service/model-pricing-list.md). +* See how charges are calculated in [Pricing](model-as-a-service/pricing.md); per-model unit prices are shown directly on the [AI Platform Portal](https://aiplatform.console.greennode.ai/models). {% hint style="info" %} Need support during the transition? Contact [support@greennode.ai](mailto:support@greennode.ai), hotline **19001549**, or the [Help Center](https://helpdesk.greennode.ai/portal/en/home). diff --git a/SUMMARY.md b/SUMMARY.md index 0fde19de..8cad43f7 100644 --- a/SUMMARY.md +++ b/SUMMARY.md @@ -79,10 +79,8 @@ * [Model as a Service](English/ai-stack/ai-platform/model-as-a-service/README.md) * [Available Models](English/ai-stack/ai-platform/model-as-a-service/available-models.md) * [MaaS API](English/ai-stack/ai-platform/model-as-a-service/maas-api.md) - * [OCR API Usage Guide](English/ai-stack/ai-platform/model-as-a-service/ocr-api-usage-guide.md) * [Playground](English/ai-stack/ai-platform/model-as-a-service/playground.md) * [Pricing](English/ai-stack/ai-platform/model-as-a-service/pricing.md) - * [Using MaaS with AI Gateway](English/ai-stack/ai-platform/model-as-a-service/using-maas-with-ai-gateway.md) * [Model Registry](English/ai-stack/ai-platform/model-registry/README.md) * [Import Model Registry Using a Custom Container](English/ai-stack/ai-platform/model-registry/import-model-registry-using-a-custom-container.md) * [Import Model Registry Using Triton](English/ai-stack/ai-platform/model-registry/import-model-registry-using-triton.md) @@ -1273,10 +1271,8 @@ * [Model as a Service](Vietnamese/ai-stack/ai-platform/model-as-a-service/README.md) * [Các Model được cung cấp](Vietnamese/ai-stack/ai-platform/model-as-a-service/cac-model-duoc-cung-cap.md) * [Cách tính phí](Vietnamese/ai-stack/ai-platform/model-as-a-service/cach-tinh-phi.md) - * [Hướng dẫn sử dụng API OCR](Vietnamese/ai-stack/ai-platform/model-as-a-service/huong-dan-su-dung-api-ocr.md) * [MaaS API](Vietnamese/ai-stack/ai-platform/model-as-a-service/maas-api.md) * [Playground](Vietnamese/ai-stack/ai-platform/model-as-a-service/playground.md) - * [Sử dụng MaaS với AI Gateway](Vietnamese/ai-stack/ai-platform/model-as-a-service/su-dung-maas-voi-ai-gateway.md) * [Model Registry](Vietnamese/ai-stack/ai-platform/model-registry/README.md) * [Import Model Registry sử dụng Triton](Vietnamese/ai-stack/ai-platform/model-registry/import-model-registry-su-dung-triton.md) * [Import Model Registry với custom container](Vietnamese/ai-stack/ai-platform/model-registry/import-model-registry-voi-custom-container.md) diff --git a/Vietnamese/SUMMARY.md b/Vietnamese/SUMMARY.md index 5fd972d4..43bab8d6 100644 --- a/Vietnamese/SUMMARY.md +++ b/Vietnamese/SUMMARY.md @@ -831,13 +831,10 @@ * [Import Model Registry với custom container](ai-stack/ai-platform/model-registry/import-model-registry-voi-custom-container.md) * [Model as a Service (MaaS)](ai-stack/model-as-a-service/README.md) * [Giới thiệu về AI Model](ai-stack/model-as-a-service/gioi-thieu-ve-ai-model.md) - * [Hướng dẫn sử dụng API OCR](ai-stack/model-as-a-service/huong-dan-su-dung-api-ocr.md) * [Playground](ai-stack/model-as-a-service/playground.md) * [Các Model được cung cấp](ai-stack/model-as-a-service/cac-model-duoc-cung-cap.md) * [MaaS API](ai-stack/model-as-a-service/maas-api.md) - * [Sử dụng MaaS với AI Gateway](ai-stack/model-as-a-service/su-dung-maas-voi-ai-gateway.md) * [Cách tính phí](ai-stack/model-as-a-service/cach-tinh-phi.md) - * [Bảng giá Model](ai-stack/model-as-a-service/bang-gia-model.md) * [AI Gateway](ai-stack/ai-gateway/README.md) * [AI Gateway là gì?](ai-stack/ai-gateway/ai-gateway-la-gi.md) * [Bắt đầu với AI Gateway](ai-stack/ai-gateway/bat-dau-voi-ai-gateway.md) diff --git a/Vietnamese/ai-stack/ai-coding/bat-dau.md b/Vietnamese/ai-stack/ai-coding/bat-dau.md index 5df51297..7af02551 100644 --- a/Vietnamese/ai-stack/ai-coding/bat-dau.md +++ b/Vietnamese/ai-stack/ai-coding/bat-dau.md @@ -70,7 +70,7 @@ Model ID của hai loại dịch vụ **có thể khác nhau** cho cùng một m Model ID dùng khi cấu hình (ví dụ PAYG): **`z-ai/glm-5.2`** {% hint style="info" %} -**GLM 5.2 ở đây chỉ là một model ví dụ.** GreenNode self-host **nhiều model** khác nhau — bạn thay bằng model mình muốn dùng. Với PAYG, **Model ID** và **Base URL** chính xác của từng model nằm trong **trang chi tiết của model đó** trên [portal Models](https://aiplatform.console.greennode.ai/models). Với Token Plan, xem tab **Models** của gói bạn đã mua. +**GLM 5.2 ở đây chỉ là một model ví dụ.** GreenNode MaaS cung cấp **nhiều model** khác nhau — bạn thay bằng model mình muốn dùng. Với PAYG, **Model ID** và **Base URL** chính xác của từng model nằm trong **trang chi tiết của model đó** trên [portal Models](https://aiplatform.console.greennode.ai/models). Với Token Plan, xem tab **Models** của gói bạn đã mua. {% endhint %} --- diff --git a/Vietnamese/ai-stack/model-as-a-service/cac-model-duoc-cung-cap.md b/Vietnamese/ai-stack/model-as-a-service/cac-model-duoc-cung-cap.md index 384f291b..3b79fcb8 100644 --- a/Vietnamese/ai-stack/model-as-a-service/cac-model-duoc-cung-cap.md +++ b/Vietnamese/ai-stack/model-as-a-service/cac-model-duoc-cung-cap.md @@ -1,41 +1,46 @@ # Các Model được cung cấp -MaaS API cung cấp quyền truy cập với độ chính xác đầy đủ vào các họ mô hình Gemini, Anthropic, OpenAI... được liệt kê bên dưới. +MaaS API cung cấp quyền truy cập với độ chính xác đầy đủ vào các họ mô hình Anthropic, OpenAI, Qwen... được liệt kê bên dưới. {% hint style="info" %} -Danh mục model bên dưới đã được cập nhật theo lộ trình chuyển đổi bắt đầu **03/08/2026**, gồm model do GreenNode self-host và model third-party đã ký hợp đồng chính thức. Xem chi tiết mốc thời gian tại [Release Notes](../release-notes.md) và bảng giá đầy đủ tại [Bảng giá Model](bang-gia-model.md). +Danh mục model bên dưới đã được cập nhật theo lộ trình chuyển đổi bắt đầu **03/08/2026**, gồm model do GreenNode self-host và model third-party đã ký hợp đồng chính thức. Xem chi tiết mốc thời gian tại [Release Notes](../release-notes.md) và nguyên tắc tính phí tại [Cách tính phí](cach-tinh-phi.md). {% endhint %} ### Danh sách mô hình +Cột **Loại Provider** cho biết request của bạn được xử lý ở đâu: + +* **GreenNode self-host** — model chạy trên hạ tầng của GreenNode. +* **Third-party** — request được chuyển tiếp đến nhà cung cấp model (Anthropic, OpenAI, Moonshot AI, Qwen, MiniMax, Cohere...) theo hợp đồng chính thức. + MaaS hỗ trợ nhiều loại mô hình khác nhau: #### _Chat_ -| Model Name | Provider | Modalities (Input → Output) | Rate Limit | Sẵn có từ | -| --------------- | ----------- | ---------------------------------- | ---------- | ------------ | -| Kimi K2.7 Code | Moonshot AI | Text + Image → Text | – | 03/08/2026 | -| Kimi 2.6 | Moonshot AI | Text + Image → Text | – | 03/08/2026 | -| GLM-5.2 | Zhipu AI | Text → Text | – | 03/08/2026 | -| Gemma 4 31B-IT | Google | Text + Image → Text | – | 03/08/2026 | -| Qwen 3.7 Plus | Qwen | Text + Image + Video → Text | – | 03/08/2026 | -| Qwen 3.6 Plus | Qwen | Text + Image + Video → Text | – | 03/08/2026 | -| Qwen 3.6 Flash | Qwen | Text + Image + Video → Text | – | 03/08/2026 | -| MiniMax M3 | MiniMax | Text + Image + Video → Text | – | 03/08/2026 | -| MiniMax M2.5 | MiniMax | Text → Text | – | 03/08/2026 | -| Opus 4.8 | Anthropic | Text + Image + File → Text | – | 20/08/2026 | -| Sonnet 4.6 | Anthropic | Text + Image + File → Text | – | 20/08/2026 | -| Haiku 4.5 | Anthropic | Text + Image + File → Text | – | 20/08/2026 | -| GPT-5.4 | OpenAI | Text + Image + File → Text | – | 20/08/2026 | -| GPT-5.4 Mini | OpenAI | Text + Image + File → Text | – | 20/08/2026 | -| GPT-5.4 Nano | OpenAI | Text + Image + File → Text | – | 20/08/2026 | -| GPT-5 | OpenAI | Text + Image + File → Text | – | 20/08/2026 | -| GPT-5 Mini | OpenAI | Text + Image + File → Text | – | 20/08/2026 | -| GPT-5 Nano | OpenAI | Text + Image + File → Text | – | 20/08/2026 | -| GPT-4o | OpenAI | Text + Image + File → Text | – | 20/08/2026 | -| GPT-4o Mini | OpenAI | Text + Image + File → Text | – | 20/08/2026 | -| GPT-OSS 20B | OpenAI | Text → Text | – | 20/08/2026 | -| GPT-OSS 120B | OpenAI | Text → Text | – | 20/08/2026 | +| Model Name | Loại Provider | Modalities (Input → Output) | Rate Limit | Sẵn có từ | +| --------------- | ------------------- | ---------------------------------- | ---------- | ------------ | +| Kimi K2.7 Code | Third-party | Text + Image → Text | – | 03/08/2026 | +| Kimi 2.6 | Third-party | Text + Image → Text | – | 03/08/2026 | +| GLM-5.2 | GreenNode self-host | Text → Text | – | 03/08/2026 | +| Gemma 4 31B-IT | Third-party | Text + Image → Text | – | 03/08/2026 | +| Qwen 3.7 Plus | Third-party | Text + Image + Video → Text | – | 03/08/2026 | +| Qwen 3.6 Plus | Third-party | Text + Image + Video → Text | – | 03/08/2026 | +| Qwen 3.6 Flash | Third-party | Text + Image + Video → Text | – | 03/08/2026 | +| MiniMax M3 | Third-party | Text + Image + Video → Text | – | 03/08/2026 | +| MiniMax M2.5 | Third-party | Text → Text | – | 03/08/2026 | +| Opus 4.8 | Third-party | Text + Image + File → Text | – | 20/08/2026 | +| Sonnet 4.6 | Third-party | Text + Image + File → Text | – | 20/08/2026 | +| Haiku 4.5 | Third-party | Text + Image + File → Text | – | 20/08/2026 | +| GPT-5.4 | Third-party | Text + Image + File → Text | – | 20/08/2026 | +| GPT-5.4 Mini | Third-party | Text + Image + File → Text | – | 20/08/2026 | +| GPT-5.4 Nano | Third-party | Text + Image + File → Text | – | 20/08/2026 | +| GPT-5 | Third-party | Text + Image + File → Text | – | 20/08/2026 | +| GPT-5 Mini | Third-party | Text + Image + File → Text | – | 20/08/2026 | +| GPT-5 Nano | Third-party | Text + Image + File → Text | – | 20/08/2026 | +| GPT-4o | Third-party | Text + Image + File → Text | – | 20/08/2026 | +| GPT-4o Mini | Third-party | Text + Image + File → Text | – | 20/08/2026 | +| GPT-OSS 20B | Third-party | Text → Text | – | 20/08/2026 | +| GPT-OSS 120B | Third-party | Text → Text | – | 20/08/2026 | {% hint style="info" %} Modalities mô tả khả năng chung của model theo tài liệu của nhà cung cấp — khả năng thực tế có thể phụ thuộc vào endpoint API cụ thể được gọi qua MaaS. Model có mốc **03/08/2026** đã sẵn sàng sử dụng; model có mốc **20/08/2026** đang được triển khai dần và chưa khả dụng. @@ -43,22 +48,22 @@ Modalities mô tả khả năng chung của model theo tài liệu của nhà cu #### _Image Generation_ -| Model Name | Provider | Modalities (Input → Output) | Rate Limit | Sẵn có từ | -| -------------- | -------- | ------------------------------- | ---------- | ---------- | -| gpt-image-2 | OpenAI | Text + Image → Image | – | 20/08/2026 | +| Model Name | Loại Provider | Modalities (Input → Output) | Rate Limit | Sẵn có từ | +| -------------- | ------------- | ------------------------------- | ---------- | ---------- | +| gpt-image-2 | Third-party | Text + Image → Image | – | 20/08/2026 | #### _Embedding_ -| Model Name | Provider | Modalities (Input → Output) | Rate Limit | Sẵn có từ | -| -------------------- | -------- | ------------------------------- | ---------- | ---------- | -| Cohere Embed v4 | Cohere | Text + Image → Vector | – | 20/08/2026 | -| Qwen3 Embedding 8B | Qwen | Text → Vector | – | 20/08/2026 | +| Model Name | Loại Provider | Modalities (Input → Output) | Rate Limit | Sẵn có từ | +| -------------------- | ------------------- | ------------------------------- | ---------- | ---------- | +| Cohere Embed v4 | Third-party | Text + Image → Vector | – | 20/08/2026 | +| Qwen3 Embedding 8B | Third-party | Text → Vector | – | 20/08/2026 | #### _Rerank_ -| Model Name | Provider | Modalities (Input → Output) | Rate Limit | Sẵn có từ | -| ------------------------ | -------- | ------------------------------- | ---------- | ---------- | -| Cohere Rerank v4.0 pro | Cohere | Text → Ranked List | – | 20/08/2026 | +| Model Name | Loại Provider | Modalities (Input → Output) | Rate Limit | Sẵn có từ | +| ------------------------ | ------------- | ------------------------------- | ---------- | ---------- | +| Cohere Rerank v4.0 pro | Third-party | Text → Ranked List | – | 20/08/2026 | Lưu ý: diff --git a/Vietnamese/ai-stack/model-as-a-service/cach-tinh-phi.md b/Vietnamese/ai-stack/model-as-a-service/cach-tinh-phi.md index 8b6fc60f..26d18c3a 100644 --- a/Vietnamese/ai-stack/model-as-a-service/cach-tinh-phi.md +++ b/Vietnamese/ai-stack/model-as-a-service/cach-tinh-phi.md @@ -10,7 +10,7 @@ description: >- MaaS hỗ trợ nhiều loại model khác nhau, và **cách tính phí phụ thuộc vào loại model được sử dụng**. -Xem đơn giá chi tiết theo từng model tại [Bảng giá Model](bang-gia-model.md). +Đơn giá chi tiết của từng model được hiển thị trực tiếp trên [Portal AI Platform](https://aiplatform.console.greennode.ai/models). #### Phân loại model theo billing diff --git a/Vietnamese/ai-stack/model-as-a-service/gioi-thieu-ve-ai-model.md b/Vietnamese/ai-stack/model-as-a-service/gioi-thieu-ve-ai-model.md index 04316f76..89f1fc7c 100644 --- a/Vietnamese/ai-stack/model-as-a-service/gioi-thieu-ve-ai-model.md +++ b/Vietnamese/ai-stack/model-as-a-service/gioi-thieu-ve-ai-model.md @@ -58,6 +58,6 @@ Càng nhiều token trong context (prompt + lịch sử hội thoại), model x | Tôi muốn... | Đi đến | | ------------------------------------------------- | -------------------------------------------------- | | Xem danh sách model theo từng nhóm chức năng | [Các Model được cung cấp](cac-model-duoc-cung-cap.md) | -| Xem đơn giá theo model | [Bảng giá Model](bang-gia-model.md) | +| Xem cách tính phí khi dùng model | [Cách tính phí](cach-tinh-phi.md) | | Thử nhanh model trước khi tích hợp | [Playground](playground.md) | | Gọi model qua API | [MaaS API](maas-api.md) | diff --git a/Vietnamese/ai-stack/model-as-a-service/huong-dan-su-dung-api-ocr.md b/Vietnamese/ai-stack/model-as-a-service/huong-dan-su-dung-api-ocr.md deleted file mode 100644 index ff78ce8a..00000000 --- a/Vietnamese/ai-stack/model-as-a-service/huong-dan-su-dung-api-ocr.md +++ /dev/null @@ -1,122 +0,0 @@ -# Hướng dẫn sử dụng API OCR - -Tài liệu này hướng dẫn cách sử dụng OCR API - -### Submit OCR (upload file để tạo request) - -* **Method**: `POST` -* **URL**: `https://maas-llm-aiplatform-hcm.api.vngcloud.vn/maas/user-/greennode/idp/v1/ocr/ingest` -* **Headers**: - * `Authorization: Bearer ` - * `portal-user-id: ` -* **Body**: `multipart/form-data` - * `flow` (required) - * `single`: OCR 1 tài liệu - * hoặc ``: OCR theo bộ tài liệu (nếu bạn được cấp flow) - * `doc_type` (required nếu `flow=single`): `` - * `file_type` (required): `PDF` hoặc `IMAGE` - * `file` (required): file cần OCR - -#### Ví dụ - -```bash -curl --location 'https://maas-llm-aiplatform-hcm.api.vngcloud.vn/maas/user-/greennode/idp/v1/ocr/ingest' \ - --header 'Authorization: Bearer ' \ - --header 'portal-user-id: ' \ - --form 'flow="single"' \ - --form 'doc_type=""' \ - --form 'file_type="PDF"' \ - --form 'file=@""' -``` - -Response sẽ chứa: - -* `request_id`: dùng để lấy kết quả -* (tuỳ trường hợp) `file_ids`: dùng để tải ảnh kết quả - -*** - -### Get OCR Result (dùng `request_id` để lấy text/data) - -* **Method**: `GET` -* **URL**: `https://maas-llm-aiplatform-hcm.api.vngcloud.vn/maas/user-/greennode/idp/v1/ocr/ingest/` -* **Headers**: - * `Authorization: Bearer ` - * `portal-user-id: ` - -#### Ví dụ - -```bash -curl --location 'https://maas-llm-aiplatform-hcm.api.vngcloud.vn/maas/user-/greennode/idp/v1/ocr/ingest/' \ - --header 'Authorization: Bearer ' \ - --header 'portal-user-id: ' -``` - -#### Nếu gọi ra chưa thấy data? - -Điều này bình thường vì OCR đang xử lý. - -* Đợi 2–5 giây và gọi lại API này (polling). -* Nếu quá thời gian timeout mà vẫn không có dữ liệu, gửi `request_id` cho team support để kiểm tra. - -*** - -### Các API lấy thêm dữ liệu khác của OCR (tuỳ nhu cầu) - -### Lấy bảng (TABLE) - -* **Method**: `GET` -* **URL**: `https://maas-llm-aiplatform-hcm.api.vngcloud.vn/maas/user-/greennode/idp/v1/ocr/ingest/table//` - -```bash -curl --location 'https://maas-llm-aiplatform-hcm.api.vngcloud.vn/maas/user-/greennode/idp/v1/ocr/ingest/table//' \ - --header 'Authorization: Bearer ' \ - --header 'portal-user-id: ' -``` - -### Lấy kết quả chữ ký - -* **Method**: `GET` -* **URL**: `https://maas-llm-aiplatform-hcm.api.vngcloud.vn/maas/user-/greennode/idp/v1/ocr/ingest/signature//` - -```bash -curl --location 'https://maas-llm-aiplatform-hcm.api.vngcloud.vn/maas/user-/greennode/idp/v1/ocr/ingest/signature//' \ - --header 'Authorization: Bearer ' \ - --header 'portal-user-id: ' -``` - -Note: document\_id nằm trong response của Get OCR Result - -### Lấy kết quả con dấu - -* **Method**: `GET` -* **URL**: `https://maas-llm-aiplatform-hcm.api.vngcloud.vn/maas/user-/greennode/idp/v1/ocr/ingest/stamp//` - -```bash -curl --location 'https://maas-llm-aiplatform-hcm.api.vngcloud.vn/maas/user-/greennode/idp/v1/ocr/ingest/stamp//' \ - --header 'Authorization: Bearer ' \ - --header 'portal-user-id: ' -``` - -### Tải ảnh kết quả - -* **Method**: `GET` -* **URL**: `https://maas-llm-aiplatform-hcm.api.vngcloud.vn/maas/user-/greennode/idp/v1/ocr/ingest/file//` - -```bash -curl --location 'https://maas-llm-aiplatform-hcm.api.vngcloud.vn/maas/user-/greennode/idp/v1/ocr/ingest/file//' \ - --header 'Authorization: Bearer ' \ - --header 'portal-user-id: ' -``` - -*** - -### Troubleshooting nhanh - -* `403 Forbidden`: - * Thiếu/sai `Authorization` hoặc không có quyền. -* `400 Bad Request` / `4XX`: - * Thiếu field bắt buộc (`flow`, `file_type`, `file`, ...) - * `doc_type` không đúng theo cấu hình. -* Polling mãi chưa ra kết quả: - * Gửi `request_id` + thời điểm gọi + file mẫu (nếu được) cho team support. diff --git a/Vietnamese/ai-stack/model-as-a-service/maas-api.md b/Vietnamese/ai-stack/model-as-a-service/maas-api.md index f72213fe..f7ff6dbd 100644 --- a/Vietnamese/ai-stack/model-as-a-service/maas-api.md +++ b/Vietnamese/ai-stack/model-as-a-service/maas-api.md @@ -2,6 +2,8 @@ **MaaS** cung cấp một API **tương thích với OpenAI** để thực hiện suy luận mô hình một cách liền mạch. Bạn có thể dễ dàng tích hợp bằng **Python, JavaScript SDK**, hoặc trực tiếp qua **terminal với cURL**. +## 1. API tương thích OpenAI (Chat, Completion, Embedding, Image Generation) + Tham khảo các Script trong API Usage trên Portal _Curl_ @@ -15,3 +17,122 @@ _Python_ Javascript
+ +*** + +## 2. OCR API + +OCR là một loại model trong MaaS, nhưng do đặc thù xử lý tài liệu (upload file, xử lý bất đồng bộ) nên có bộ endpoint riêng thay vì dùng endpoint tương thích OpenAI ở trên. Phần dưới đây hướng dẫn cách gọi OCR API. + +### Submit OCR (upload file để tạo request) + +* **Method**: `POST` +* **URL**: `https://maas-llm-aiplatform-hcm.api.vngcloud.vn/maas/user-/greennode/idp/v1/ocr/ingest` +* **Headers**: + * `Authorization: Bearer ` + * `portal-user-id: ` +* **Body**: `multipart/form-data` + * `flow` (required) + * `single`: OCR 1 tài liệu + * hoặc ``: OCR theo bộ tài liệu (nếu bạn được cấp flow) + * `doc_type` (required nếu `flow=single`): `` + * `file_type` (required): `PDF` hoặc `IMAGE` + * `file` (required): file cần OCR + +#### Ví dụ + +```bash +curl --location 'https://maas-llm-aiplatform-hcm.api.vngcloud.vn/maas/user-/greennode/idp/v1/ocr/ingest' \ + --header 'Authorization: Bearer ' \ + --header 'portal-user-id: ' \ + --form 'flow="single"' \ + --form 'doc_type=""' \ + --form 'file_type="PDF"' \ + --form 'file=@""' +``` + +Response sẽ chứa: + +* `request_id`: dùng để lấy kết quả +* (tuỳ trường hợp) `file_ids`: dùng để tải ảnh kết quả + +### Get OCR Result (dùng `request_id` để lấy text/data) + +* **Method**: `GET` +* **URL**: `https://maas-llm-aiplatform-hcm.api.vngcloud.vn/maas/user-/greennode/idp/v1/ocr/ingest/` +* **Headers**: + * `Authorization: Bearer ` + * `portal-user-id: ` + +#### Ví dụ + +```bash +curl --location 'https://maas-llm-aiplatform-hcm.api.vngcloud.vn/maas/user-/greennode/idp/v1/ocr/ingest/' \ + --header 'Authorization: Bearer ' \ + --header 'portal-user-id: ' +``` + +#### Nếu gọi ra chưa thấy data? + +Điều này bình thường vì OCR đang xử lý. + +* Đợi 2–5 giây và gọi lại API này (polling). +* Nếu quá thời gian timeout mà vẫn không có dữ liệu, gửi `request_id` cho team support để kiểm tra. + +### Các API lấy thêm dữ liệu khác của OCR (tuỳ nhu cầu) + +#### Lấy bảng (TABLE) + +* **Method**: `GET` +* **URL**: `https://maas-llm-aiplatform-hcm.api.vngcloud.vn/maas/user-/greennode/idp/v1/ocr/ingest/table//` + +```bash +curl --location 'https://maas-llm-aiplatform-hcm.api.vngcloud.vn/maas/user-/greennode/idp/v1/ocr/ingest/table//' \ + --header 'Authorization: Bearer ' \ + --header 'portal-user-id: ' +``` + +#### Lấy kết quả chữ ký + +* **Method**: `GET` +* **URL**: `https://maas-llm-aiplatform-hcm.api.vngcloud.vn/maas/user-/greennode/idp/v1/ocr/ingest/signature//` + +```bash +curl --location 'https://maas-llm-aiplatform-hcm.api.vngcloud.vn/maas/user-/greennode/idp/v1/ocr/ingest/signature//' \ + --header 'Authorization: Bearer ' \ + --header 'portal-user-id: ' +``` + +Note: document\_id nằm trong response của Get OCR Result + +#### Lấy kết quả con dấu + +* **Method**: `GET` +* **URL**: `https://maas-llm-aiplatform-hcm.api.vngcloud.vn/maas/user-/greennode/idp/v1/ocr/ingest/stamp//` + +```bash +curl --location 'https://maas-llm-aiplatform-hcm.api.vngcloud.vn/maas/user-/greennode/idp/v1/ocr/ingest/stamp//' \ + --header 'Authorization: Bearer ' \ + --header 'portal-user-id: ' +``` + +#### Tải ảnh kết quả + +* **Method**: `GET` +* **URL**: `https://maas-llm-aiplatform-hcm.api.vngcloud.vn/maas/user-/greennode/idp/v1/ocr/ingest/file//` + +```bash +curl --location 'https://maas-llm-aiplatform-hcm.api.vngcloud.vn/maas/user-/greennode/idp/v1/ocr/ingest/file//' \ + --header 'Authorization: Bearer ' \ + --header 'portal-user-id: ' +``` + +### Troubleshooting nhanh cho OCR + +* `403 Forbidden`: + * Thiếu/sai `Authorization` hoặc không có quyền. +* `400 Bad Request` / `4XX`: + * Thiếu field bắt buộc (`flow`, `file_type`, `file`, ...) + * `doc_type` không đúng theo cấu hình. +* Polling mãi chưa ra kết quả: + * Gửi `request_id` + thời điểm gọi + file mẫu (nếu được) cho team support. diff --git a/Vietnamese/ai-stack/release-notes.md b/Vietnamese/ai-stack/release-notes.md index 2d7bcb4f..c4aeec08 100644 --- a/Vietnamese/ai-stack/release-notes.md +++ b/Vietnamese/ai-stack/release-notes.md @@ -22,7 +22,7 @@ GreenNode cập nhật danh mục model trên MaaS thành hai nhóm — **model * Model hiện tại ngừng cung cấp & danh mục mới lên portal từ **03/08/2026**, gia hạn tự động đến **02/09/2026** trước khi request đến model cũ bắt đầu trả lỗi. * Đối chiếu model đang dùng với [danh mục mới](model-as-a-service/cac-model-duoc-cung-cap.md); chỉ cần đổi model nếu model hiện tại không còn trong danh mục. -* Xem chi tiết giá tại [Bảng giá Model](model-as-a-service/bang-gia-model.md). +* Xem chi tiết cách tính phí tại [Cách tính phí](model-as-a-service/cach-tinh-phi.md); đơn giá của từng model được hiển thị trực tiếp trên [Portal AI Platform](https://aiplatform.console.greennode.ai/models). {% hint style="info" %} Cần hỗ trợ trong quá trình chuyển đổi? Liên hệ [support@greennode.ai](mailto:support@greennode.ai), hotline **19001549**, hoặc [Trung tâm hỗ trợ](https://helpdesk.greennode.ai/portal/vi/home).