Skip to main content

OpenAI Compatible API Integration

Nuclia provides an OpenAI-compatible API so you can plug in with existing OpenAI or OpenRouter tooling by updating the base URL and API key.

Get your NUA key​

  1. Go to manage your account.

Manage account

  1. Open NUA Keys.

NUA Keys

  1. Create a new key.

Create key

Configure the API endpoint​

Use your zone id in the base URL:

https://[zone-id].rag.progress.cloud/api/v1/predict/compat

Authentication​

Use your NUA key as a standard Bearer token. This works the same as OpenAI or OpenRouter.

Authorization: Bearer <NUA KEY>

Example integrations​

OpenCode​

Reference: https://opencode.ai/docs/providers/

Example ~/.config/opencode/opencode.json:

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "nuclia": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Nuclia",
      "options": {
        "baseURL": "https://aws-us-east-2-1.rag.progress.cloud/api/v1/predict/compat"
      },
      "models": {
        "aws-claude-4-5-sonnet": { "name": "aws-claude-4-5-sonnet" },
        "aws-claude-4-5-haiku": { "name": "aws-claude-4-5-haiku" },
        "chatgpt4o": { "name": "chatgpt4o" }
      }
    }
  },
  "model": "aws-claude-4-5-haiku",
  "small_model": "aws-claude-4-5-sonnet"
}

Example ~/.local/share/opencode/auth.json:

{
  "nuclia": {
    "type": "api",
    "key": "<NUA KEY>"
  }
}

Available models​

  • claude-4-opus
  • claude-4-sonnet
  • claude-4-5-sonnet
  • claude-4-5-haiku
  • gcp-claude-3-7-sonnet
  • gcp-claude-4-5-sonnet
  • gcp-claude-4-5-haiku
  • aws-claude-3-7-sonnet
  • aws-claude-4-sonnet
  • aws-claude-4-opus
  • aws-claude-4-1-opus
  • aws-claude-4-5-sonnet
  • aws-claude-4-5-haiku
  • gemini-2.0-flash
  • gemini-2.0-flash-lite
  • gemini-2.5-pro
  • gemini-2.5-flash
  • gemini-2.5-flash-lite
  • gemini-2.5-flash-image
  • gemini-3-pro
  • gemini-3-pro-image
  • chatgpt4
  • chatgpt4o
  • chatgpt4o-mini
  • chatgpt-o1
  • chatgpt-o3
  • chatgpt-o3-mini
  • chatgpt-o4-mini
  • chatgpt-4.1
  • chatgpt-5
  • chatgpt-5-mini
  • chatgpt-5-nano
  • chatgpt-5-chat
  • chatgpt-azure-4o
  • chatgpt-azure-4o-mini
  • chatgpt-azure-o1
  • chatgpt-azure-o3-mini
  • chatgpt-azure-o3
  • chatgpt-azure-o4-mini
  • chatgpt-azure-5
  • chatgpt-azure-5-mini
  • chatgpt-azure-5-nano
  • chatgpt-azure-5-chat
  • azure-deepseek-r1
  • azure-gpt-oss-120b