GonkaGate Examples: OpenAI-Compatible SDK and Production Integration Examples

This repository provides runnable GonkaGate examples for developers who need a fast path from API key to production-ready integration.

GonkaGate is an OpenAI-compatible API gateway to Gonka Network with USD billing. Most integrations work by changing api_key and base_url/baseURL.

Why this repository

• Reduce time to first successful request to 5-10 minutes.
• Validate chat and streaming flows with copy-paste commands.
• Reuse production-style examples for web apps and agents.
• Standardize handling for 401, 402, 429, and 503 errors.

Quick Start

1. Clone this repository.
2. Choose an example from sdk/ or examples/.
3. Copy .env.example to .env in that folder.
4. Set GONKAGATE_API_KEY and GONKAGATE_MODEL.
5. Run the commands from that example README.

Repository Structure

/
  README.md
  AGENTS.md
  .github/
    workflows/ci.yml
  sdk/
    <language>/<example-name>/
  examples/
    <example-name>/
    agents/<example-name>/

SDK Quickstarts

• cURL Chat Completions
• C# OpenAI Chat
• C# OpenAI Streaming
• Go OpenAI Chat
• Go OpenAI Streaming
• Java OpenAI Chat
• Java OpenAI Streaming
• Node.js OpenAI Chat
• Node.js OpenAI Streaming
• Python OpenAI Chat
• Python OpenAI Streaming

Production-Style Examples

• Next.js Vercel AI SDK Chat
• Cross-Platform CLI Chat (Go)
• LangChain Basic Agent
• LangChain Streaming Agent
• LangChain Structured Output Agent

SDK Docs by Language

• Python SDK docs
• TypeScript SDK docs (Node.js)
• Go SDK docs
• .NET SDK docs (C#)
• Java SDK docs
• cURL setup path

Contribution Standard

Each example folder should include:

• README.md with setup, run commands, expected output, and troubleshooting.
• .env.example with placeholders only.
• Self-contained source files that run independently.

Learn More

• Gonka API
• GonkaGate SDK Overview
• Quickstart Guide
• API Reference
• Available Models
• Pricing
• Public Chat Playground

Related Pages

• SDK index: sdk/README.md
• Examples index: examples/README.md
• Contributing guide: CONTRIBUTING.md
• Support: SUPPORT.md
• Security policy: SECURITY.md

License

Apache-2.0. See LICENSE.