Back to DadGPT
API Docs

DadGPT API Documentation

Full setup guide for OpenAI-compatible clients, API keys, chat completions, model selection, streaming, and provider-key troubleshooting.

DadGPT OpenAI-Compatible API Reference

This document describes how to use the DadGPT API with agentic coding tools like Cline, Roo Code, Continue, Aider, and other OpenAI-compatible clients.

Quick Start

Base URL

https://www.dadgpt.live/v1

1. Create a DadGPT API Key

  1. Log in to DadGPT.
  2. Go to Settings -> API Keys.
  3. Click Create New API Key.
  4. Copy the key immediately. It is shown only once.

DadGPT API keys start with:

sk-dad_

2. Use the Key in Requests

All API requests require the key in the Authorization header:

Authorization: Bearer sk-dad_your_api_key_here

3. Configure Your Client

Use these values in any OpenAI-compatible app:

SettingValue
ProviderOpenAI-compatible
Base URLhttps://www.dadgpt.live/v1
API Keysk-dad_your_api_key_here
Modeldadgpt-default or dadgpt-beast

Endpoints

POST /v1/chat/completions

Generate AI chat completions. Supports both streaming and non-streaming responses.

Request Body

ParameterTypeRequiredDefaultDescription
modelstringNodadgpt-defaultModel to use. Options: dadgpt-default, dadgpt-beast
messagesarrayYes-Array of message objects with role and content
streambooleanNofalseWhether to stream the response
temperaturenumberNo0.9Sampling temperature (0-2)
max_tokensnumberNo4096Maximum tokens to generate
top_pnumberNo0.95Nucleus sampling parameter
frequency_penaltynumberNo0.5Frequency penalty (-2 to 2)
presence_penaltynumberNo0.5Presence penalty (-2 to 2)

Message Object

{
  "role": "user" | "assistant" | "system",
  "content": "Your message here"
}

Example Request

curl -X POST https://www.dadgpt.live/v1/chat/completions \
  -H "Authorization: Bearer sk-dad_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "dadgpt-default",
    "messages": [
      {"role": "system", "content": "You are a helpful coding assistant"},
      {"role": "user", "content": "Write a Python function to calculate fibonacci numbers"}
    ],
    "stream": true
  }'

Response (Non-Streaming)

{
  "id": "chatcmpl-abc123xyz",
  "object": "chat.completion",
  "created": 1703123456,
  "model": "dadgpt-default",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "Here's a Python function..."
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 25,
    "completion_tokens": 150,
    "total_tokens": 175
  }
}

Response (Streaming)

Streaming responses use Server-Sent Events (SSE):

data: {"id":"chatcmpl-abc123","object":"chat.completion.chunk","created":1703123456,"model":"dadgpt-default","choices":[{"index":0,"delta":{"role":"assistant"},"finish_reason":null}]} data: {"id":"chatcmpl-abc123","object":"chat.completion.chunk","created":1703123456,"model":"dadgpt-default","choices":[{"index":0,"delta":{"content":"Here's"},"finish_reason":null}]} data: {"id":"chatcmpl-abc123","object":"chat.completion.chunk","created":1703123456,"model":"dadgpt-default","choices":[{"index":0,"delta":{"content":" a"},"finish_reason":null}]} ... data: {"id":"chatcmpl-abc123","object":"chat.completion.chunk","created":1703123456,"model":"dadgpt-default","choices":[{"index":0,"delta":{},"finish_reason":"stop"}]} data: [DONE]

GET /v1/models

List available models.

Example Request

curl https://www.dadgpt.live/v1/models \
  -H "Authorization: Bearer sk-dad_your_api_key"

Response

{
  "object": "list",
  "data": [
    {
      "id": "dadgpt-default",
      "object": "model",
      "created": 1703123456,
      "owned_by": "dadgpt"
    },
    {
      "id": "dadgpt-beast",
      "object": "model",
      "created": 1703123456,
      "owned_by": "dadgpt"
    }
  ]
}

Models

ModelDescriptionToken Cost
dadgpt-defaultBalanced model for general use1 token/request
dadgpt-beastExtended context, more detailed responses3 tokens/request

Rate Limits

  • Default: 60 requests per minute per API key
  • Rate limit headers are included in responses:
    • X-RateLimit-Limit: Maximum requests per minute
    • X-RateLimit-Remaining: Remaining requests in current window
    • X-RateLimit-Reset: Unix timestamp when the limit resets

Error Responses

All errors follow the OpenAI error format:

{
  "error": {
    "message": "Error description",
    "type": "error_type",
    "param": null,
    "code": "error_code"
  }
}

Error Codes

StatusCodeDescription
401missing_api_keyMissing Authorization: Bearer sk-dad_... header
401invalid_api_keyInvalid DadGPT API key
401api_key_expiredAPI key has expired
402insufficient_quotaInsufficient tokens in account
403account_suspendedAccount has been suspended
429rate_limit_exceededToo many requests
400invalid_requestMalformed request
400model_not_foundInvalid model specified
500internal_errorServer error

Troubleshooting 401 Errors

If you get a 401 error, check the following:

  1. The Authorization header is present and formatted as Bearer sk-dad_your_api_key.
  2. The API key is copied correctly with no extra spaces.
  3. The API key has not been deleted or expired in Settings -> API Keys.

If the key still fails, create a new key in Settings -> API Keys and try again.

Tool Configurations

Cline (VS Code)

In your VS Code settings (settings.json):

{
  "cline.apiProvider": "openai-compatible",
  "cline.apiBaseUrl": "https://www.dadgpt.live/v1",
  "cline.apiKey": "sk-dad_your_api_key_here",
  "cline.model": "dadgpt-default"
}

Roo Code

{
  "roo.provider": "openai-compatible",
  "roo.baseUrl": "https://www.dadgpt.live/v1",
  "roo.apiKey": "sk-dad_your_api_key_here",
  "roo.model": "dadgpt-default"
}

Continue

In your Continue configuration (~/.continue/config.json):

{
  "models": [
    {
      "title": "DadGPT",
      "provider": "openai",
      "model": "dadgpt-default",
      "apiBase": "https://www.dadgpt.live/v1",
      "apiKey": "sk-dad_your_api_key_here"
    }
  ]
}

Aider

export OPENAI_API_BASE=https://www.dadgpt.live/v1
export OPENAI_API_KEY=sk-dad_your_api_key_here
aider --model dadgpt-default

OpenAI Python SDK

from openai import OpenAI

client = OpenAI(
    api_key="sk-dad_your_api_key_here",
    base_url="https://www.dadgpt.live/v1"
)

response = client.chat.completions.create(
    model="dadgpt-default",
    messages=[
        {"role": "user", "content": "Hello!"}
    ],
    stream=True
)

for chunk in response:
    if chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="")

curl

curl -X POST https://www.dadgpt.live/v1/chat/completions \
  -H "Authorization: Bearer sk-dad_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "dadgpt-default",
    "messages": [{"role": "user", "content": "Hello!"}]
  }'

Best Practices

  1. Keep your API key secure - Never commit API keys to version control
  2. Use environment variables - Store keys in environment variables, not code
  3. Handle rate limits - Implement exponential backoff for 429 responses
  4. Use streaming for long responses - Streaming provides better UX for code generation
  5. Monitor your usage - Check the Settings page for API usage statistics

Support

  • Telegram: @Automax_0
  • Issues: Create an issue on GitHub