Opencode

Use a Valkyrie model in Opencode as a custom OpenAI-compatible provider.

Opencode lets you add a custom provider through its AI SDK support, so you can point it at a Valkyrie deployment over the OpenAI-compatible API.

Configure the provider

Add Valkyrie to your Opencode config, either global at ~/.config/opencode/opencode.json or per-project at ./opencode.json:

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "valkyrie": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Valkyrie",
      "options": {
        "baseURL": "https://valkyrie-back.azumo.com/{deployment_slug}/v1",
        "apiKey": "{env:VALKYRIE_API_KEY}"
      },
      "models": {
        "your-model-id": { "name": "Valkyrie model" }
      }
    }
  },
  "model": "valkyrie/your-model-id"
}

Then export your key and start Opencode:

export VALKYRIE_API_KEY="vk_dep_your_deployment_key"
opencode

The baseURL ends in /v1. Use your deployment slug (deployment-{id}) or an alias in place of {deployment_slug}, and set your-model-id to the model your deployment serves. {env:VAR} reads the key from the environment so it never lands in the config file.

A real example

Against Valkyrie’s shared Qwen deployment (alias qwen, model RadixArk/Qwen3.8-27B-NVFP4):

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "valkyrie": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Valkyrie",
      "options": {
        "baseURL": "https://valkyrie-back.azumo.com/qwen/v1",
        "apiKey": "{env:VALKYRIE_API_KEY}"
      },
      "models": {
        "RadixArk/Qwen3.8-27B-NVFP4": { "name": "Valkyrie Qwen 27B" }
      }
    }
  },
  "model": "valkyrie/RadixArk/Qwen3.8-27B-NVFP4"
}