Skill: germey/acedatacloud-ai-chat (version 1.0.0)

--- name: ai-chat description: Access 50+ LLM models through a unified OpenAI-compatible API via AceDataCloud. Use when you need chat completions from GPT, Claude, Gemini, DeepSeek, Grok, or other models through a single endpoint. Supports streaming, function calling, and vision. license: Apache-2.0 metadata: author: acedatacloud version: "1.0" compatibility: Requires ACEDATACLOUD_API_TOKEN environment variable. Works as a drop-in replacement for the OpenAI SDK. --- # AI Chat — Unified LLM Gateway Access 50+ language models through a single OpenAI-compatible endpoint via AceDataCloud. ## Authentication ```bash export ACEDATACLOUD_API_TOKEN="your-token-here" ``` ## Quick Start ```bash curl -X POST https://api.acedata.cloud/v1/chat/completions \ -H "Authorization: Bearer $ACEDATACLOUD_API_TOKEN" \ -H "Content-Type: application/json" \ -d '{"model": "claude-sonnet-4-20250514", "messages": [{"role": "user", "content": "Hello!"}]}' ``` ## OpenAI SDK Drop-in ```python from openai import OpenAI client = OpenAI( [REDACTED_SECRET]", base_url="https://api.acedata.cloud/v1" ) response = client.chat.completions.create( model="gpt-4.1", messages=[{"role": "user", "content": "Explain quantum computing"}] ) print(response.choices[0].message.content) ``` ## Available Models ### OpenAI GPT | Model | Type | Best For | |-------|------|----------| | `gpt-4.1` | Latest | General-purpose, high quality | | `gpt-4.1-mini` | Small | Fast, cost-effective | | `gpt-4.1-nano` | Tiny | Ultra-fast, lowest cost | | `gpt-4o` | Multimodal | Vision + text | | `gpt-4o-mini` | Small multimodal | Fast vision tasks | | `o1` | Reasoning | Complex reasoning tasks | | `o1-mini` | Small reasoning | Quick reasoning | | `o1-pro` | Pro reasoning | Advanced reasoning | | `gpt-5` | Latest gen | Next-gen intelligence | | `gpt-5-mini` | Mini gen 5 | Fast next-gen | ### Anthropic Claude | Model | Type | Best For | |-------|------|----------| | `claude-opus-4-6` | Latest Opus | Highest capability | | `claude-sonnet-4-6` | Latest Sonnet | Balanced quality/speed | | `claude-opus-4-5-20251101` | Opus 4.5 | Premium tasks | | `claude-sonnet-4-5-20250929` | Sonnet 4.5 | High-quality balance | | `claude-sonnet-4-20250514` | Sonnet 4 | Reliable general-purpose | | `claude-haiku-4-5-20251001` | Haiku 4.5 | Fast, efficient | | `claude-3-5-sonnet-20241022` | Legacy 3.5 | Proven track record | | `claude-3-opus-20240229` | Legacy Opus | Maximum quality (legacy) | ### Google Gemini | Model | Best For | |-------|----------| | `gemini-1.5-pro` | Long context, complex tasks | | `gemini-1.5-flash` | Fast, efficient | ### DeepSeek | Model | Best For | |-------|----------| | `deepseek-r1` | Deep reasoning | | `deepseek-r1-0528` | Latest reasoning | | `deepseek-v3` | General-purpose | | `deepseek-v3-250324` | Latest general | ### xAI Grok | Model | Best For | |-------|----------| | `grok-4` | Latest, highest capability | | `grok-3` | General-purpose | | `grok-3-fast` | Speed-optimized | | `grok-3-mini` | Compact, efficient | ## Features ### Streaming ```json POST /v1/chat/completions { "model": "claude-sonnet-4-20250514", "messages": [{"role": "user", "content": "Write a story"}], "stream": true } ``` ### Function Calling ```json POST /v1/chat/completions { "model": "gpt-4.1", "messages": [{"role": "user", "content": "What's the weather in Tokyo?"}], "tools": [ { "type": "function", "function": { "name": "get_weather", "parameters": {"type": "object", "properties": {"location": {"type": "string"}}} } } ] } ``` ### Vision ```json POST /v1/chat/completions { "model": "gpt-4o", "messages": [ { "role": "user", "content": [ {"type": "text", "text": "What's in this image?"}, {"type": "image_url", "image_url": {"url": "https://example.com/photo.jpg"}} ] } ] } ``` ## Parameters | Parameter | Type | Description | |-----------|------|-------------| | `model` | string | Model name (see tables above) | | `messages` | array | Array of `{role, content}` objects | | `temperature` | 0–2 | Randomness (default: 1) | | `top_p` | 0–1 | Nucleus sampling | | `max_tokens` | integer | Maximum output tokens | | `stream` | boolean | Enable SSE streaming | | `tools` | array | Function calling definitions | | `tool_choice` | string/object | Tool selection strategy | ## Response ```json { "id": "chatcmpl-xxx", "object": "chat.completion", "model": "claude-sonnet-4-20250514", "choices": [ { "index": 0, "message": {"role": "assistant", "content": "Hello!"}, "finish_reason": "stop" } ], "usage": { "prompt_tokens": 10, "completion_tokens": 5, "total_tokens": 15 } } ``` ## Gotchas - **100% OpenAI-compatible** — use the standard OpenAI SDK with `base_url="https://api.acedata.cloud/v1"` - Billing is token-based with per-model pricing (more expensive models cost more per token) - Vision is supported on multimodal models (`gpt-4o`, `gpt-4o-mini`, `grok-2-vision-*`) - Function calling works on most modern models (GPT-4+, Claude 3+) - Streaming returns `chat.completion.chunk` objects via SSE - `finish_reason` values: `"stop"` (complete), `"length"` (max tokens), `"tool_calls"` (function call), `"content_filter"` (filtered)


Security scan verdicts — ClawScan: clean | static analysis: clean | VirusTotal: clean | SkillSpector: clean (LOW)