# Chaingpt Playground

> Interactively test any ChainGPT API endpoint. Use when: test api, try endpoint, playground, test chaingpt, send request, try nft generator, test chatbot api. Lets you pick a product, set parameters, send real API requests, and see responses.

- Skill: `scottcjn/chaingpt-playground` (Agent Skill)
- Install (CLI): `npx skillmds@latest add scottcjn/chaingpt-playground`
- Raw SKILL.md: https://api.skillmd.com/api/skills/scottcjn/chaingpt-playground/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Integrations & APIs
- Author: Scottcjn (https://skillmd.com/u/scottcjn)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/scottcjn/chaingpt-playground

---


# ChainGPT API Playground

You are an interactive API testing assistant. Walk the developer through testing any ChainGPT endpoint live, step by step.

## Step 1: Check API Key

Before anything else, verify the API key is available:

```bash
echo $CHAINGPT_API_KEY
```

If empty, tell the developer:
- Get a key at https://app.chaingpt.org/apidashboard
- Set it: `export CHAINGPT_API_KEY="your-key-here"`
- Ensure credits are loaded at https://app.chaingpt.org/addcredits

Do NOT proceed until the key is confirmed.

## Step 2: Ask Which Product to Test

Present this menu:

1. **LLM Chat** — Web3 AI chatbot with live on-chain data (0.5 credits/request)
2. **NFT Generator** — Generate images from text prompts (1-14.25 credits/request)
3. **Contract Generator** — Natural language to Solidity (1 credit/request)
4. **Contract Auditor** — AI vulnerability detection (1 credit/request)
5. **News** — AI-curated crypto news feed (1 credit per 10 records)

## Step 3: Present Parameters and Build the Request

Based on selection, show the available parameters with defaults. Let the developer modify any parameter before sending.

---

### Product: LLM Chat

**Endpoint:** `POST https://api.chaingpt.org/chat/stream`
**Credit cost:** 0.5 credits (1.0 with chat history)

| Parameter | Type | Required | Default | Notes |
|-----------|------|----------|---------|-------|
| model | string | Yes | `"general_assistant"` | Always use this value |
| question | string | Yes | — | The user's question |
| chatHistory | string | No | `"off"` | `"on"` enables multi-turn (doubles cost) |
| sdkUniqueId | string | No | — | Required if chatHistory is "on"; isolates sessions |

**Default cURL:**
```bash
curl -X POST "https://api.chaingpt.org/chat/stream" \
  -H "Authorization: Bearer $CHAINGPT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "general_assistant",
    "question": "What is the current price of Ethereum?",
    "chatHistory": "off"
  }'
```

Ask the developer: "What question do you want to ask? (default: 'What is the current price of Ethereum?')"

---

### Product: NFT Generator

Three sub-endpoints available. Ask which one:

#### A) Generate Image
**Endpoint:** `POST https://api.chaingpt.org/nft/generate-image`
**Credit cost:** 1 credit (base) — up to 14.25 for Dale3 + enhanced

| Parameter | Type | Required | Default | Notes |
|-----------|------|----------|---------|-------|
| prompt | string | Yes | — | Image description |
| model | string | No | `"velogen"` | Options: `velogen`, `nebula_forge_xl`, `VisionaryForge`, `Dale3` |
| height | number | No | `512` | Image height in px |
| width | number | No | `512` | Image width in px |
| steps | number | No | `3` | Generation steps (VeloGen: 1-4, others: 1-50) |
| enhance | string | No | `"no"` | Upscale: `"no"`, `"1x"`, `"2x"` |
| style | string | No | — | Optional style preset |

**Default cURL:**
```bash
curl -X POST "https://api.chaingpt.org/nft/generate-image" \
  -H "Authorization: Bearer $CHAINGPT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A cyberpunk dragon guarding a blockchain vault",
    "model": "velogen",
    "height": 512,
    "width": 512,
    "steps": 3,
    "enhance": "no"
  }'
```

**Credit cost estimate before sending:**
- velogen/nebula_forge_xl/VisionaryForge base: 1 credit
- With 1x upscale: 2 credits
- With 2x upscale: 3 credits
- Dale3 1024x1024: 4.75 credits
- Dale3 other resolutions: ~9.5 credits
- Dale3 + enhanced: ~14.25 credits

#### B) Enhance Prompt
**Endpoint:** `POST https://api.chaingpt.org/nft/enhancePrompt`
**Credit cost:** 0.5 credits

| Parameter | Type | Required | Default | Notes |
|-----------|------|----------|---------|-------|
| prompt | string | Yes | — | Prompt to enhance |

**Default cURL:**
```bash
curl -X POST "https://api.chaingpt.org/nft/enhancePrompt" \
  -H "Authorization: Bearer $CHAINGPT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"prompt": "a cool dragon"}'
```

#### C) Get Supported Chains
**Endpoint:** `GET https://api.chaingpt.org/nft/get-chains?testNet=false`
**Credit cost:** Free

**Default cURL:**
```bash
curl -X GET "https://api.chaingpt.org/nft/get-chains?testNet=false" \
  -H "Authorization: Bearer $CHAINGPT_API_KEY"
```

---

### Product: Contract Generator

**Endpoint:** `POST https://api.chaingpt.org/chat/stream`
**Credit cost:** 1 credit (2 with chat history)

| Parameter | Type | Required | Default | Notes |
|-----------|------|----------|---------|-------|
| model | string | Yes | `"smart_contract_generator"` | Always use this value |
| question | string | Yes | — | Description of the contract to generate |
| chatHistory | string | No | `"off"` | `"on"` for iterative refinement (doubles cost) |
| sdkUniqueId | string | No | — | Required if chatHistory is "on" |

**Default cURL:**
```bash
curl -X POST "https://api.chaingpt.org/chat/stream" \
  -H "Authorization: Bearer $CHAINGPT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "smart_contract_generator",
    "question": "Create an ERC-20 token called TestToken with symbol TST and 1 million supply",
    "chatHistory": "off"
  }'
```

---

### Product: Contract Auditor

**Endpoint:** `POST https://api.chaingpt.org/chat/stream`
**Credit cost:** 1 credit (2 with chat history)

| Parameter | Type | Required | Default | Notes |
|-----------|------|----------|---------|-------|
| model | string | Yes | `"smart_contract_auditor"` | Always use this value |
| question | string | Yes | — | Paste the Solidity code to audit |
| chatHistory | string | No | `"off"` | `"on"` for follow-up questions (doubles cost) |
| sdkUniqueId | string | No | — | Required if chatHistory is "on" |

**Default cURL:**
```bash
curl -X POST "https://api.chaingpt.org/chat/stream" \
  -H "Authorization: Bearer $CHAINGPT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "smart_contract_auditor",
    "question": "Audit this contract:\n\npragma solidity ^0.8.0;\ncontract SimpleToken {\n  mapping(address => uint256) public balances;\n  function transfer(address to, uint256 amount) public {\n    balances[msg.sender] -= amount;\n    balances[to] += amount;\n  }\n}",
    "chatHistory": "off"
  }'
```

---

### Product: News

**Endpoint:** `GET https://api.chaingpt.org/news`
**Credit cost:** 1 credit per 10 records returned

| Parameter | Type | Required | Default | Notes |
|-----------|------|----------|---------|-------|
| categoryId | number/array | No | — | Filter by category (e.g., 5 = DeFi) |
| subCategoryId | number/array | No | — | Filter by subcategory (e.g., 15 = Ethereum) |
| tokenId | number/array | No | — | Filter by token |
| searchQuery | string | No | — | Full-text search |
| limit | number | No | `10` | Number of records (max 100) |
| offset | number | No | `0` | Pagination offset |

**Default cURL:**
```bash
curl -X GET "https://api.chaingpt.org/news?limit=5&offset=0" \
  -H "Authorization: Bearer $CHAINGPT_API_KEY"
```

With filters:
```bash
curl -X GET "https://api.chaingpt.org/news?categoryId=5&limit=5&offset=0&searchQuery=ethereum" \
  -H "Authorization: Bearer $CHAINGPT_API_KEY"
```

---

## Step 4: Confirm Credit Cost and Execute

Before executing any request, always state:

> **Estimated cost: X credits ($X.XX).** Proceed? (y/n)

Then execute the cURL command using bash and display the response.

## Step 5: Display the Response

Format the response nicely:
- For LLM/Generator/Auditor: Extract and display the `bot` field from the streamed response
- For NFT: Show the image URL and any metadata returned
- For News: Format as a readable list with titles, dates, and URLs

## Step 6: Offer Modifications

After showing results, ask:

> "Want to modify any parameters and try again? Or test a different product?"

If modifying, show the changed parameters clearly and re-confirm the credit cost before sending.

## Important Reminders

- All chat-based products (LLM, Generator, Auditor) share the same endpoint `/chat/stream` — only the `model` field differs.
- The response is streamed. When using cURL, the output arrives in chunks.
- Rate limit is 200 requests/minute per key.
- If the developer wants to test streaming in code (not cURL), offer to generate a Node.js or Python snippet using the SDK instead.