oatda-text-completion

OATDA Text Completion

Generate text from 10+ LLM providers through OATDA's unified API endpoint.

When to Use

Use this skill when the user wants to:

• Generate text using a specific LLM provider through the OATDA API
• Send a prompt to OpenAI, Anthropic, Google, Deepseek, Mistral, xAI, or other providers via OATDA
• Compare outputs across different models using a single API
• Use a model by alias (e.g., "gpt-4o", "claude", "gemini")

Prerequisites

The user needs an OATDA API key. Check in this order:

1. $OATDA_API_KEY environment variable
2. ~/.oatda/credentials.json config file

If neither exists, tell the user:

You need an OATDA API key. Get one at https://oatda.com, then set it: export OATDA_API_KEY=your_key_here

Step-by-Step Instructions

1. Resolve the API key

# Check env var first; if empty, auto-load from credentials file
if [[ -z "$OATDA_API_KEY" ]]; then
  export OATDA_API_KEY=$(cat ~/.oatda/credentials.json 2>/dev/null | jq -r '.profiles[.defaultProfile].apiKey' 2>/dev/null)
fi

# Verify key exists (show first 8 chars only)
echo "${OATDA_API_KEY:0:8}"

If the output is empty or null, stop and ask the user to configure their API key.

IMPORTANT:

• Never print the full API key. Only check its existence or show the first 8 characters for verification.
• The key resolution script and subsequent curl commands must run in the same shell session. Each separate bash/terminal invocation starts with an isolated environment where previously exported variables are lost. Either run all commands in one session, or chain them (e.g., export OATDA_API_KEY=... && curl ...).

2. Determine the model

Parse the user's request for a model. Map common aliases to provider/model format:

User says	Provider	Model
gpt-4o	openai	gpt-4o
gpt-4o-mini	openai	gpt-4o-mini
gpt-5	openai	gpt-5
gpt-5-mini	openai	gpt-5-mini
o1	openai	o1
o3	openai	o3
claude, sonnet	anthropic	claude-sonnet-4-5-20250929
haiku	anthropic	claude-haiku-4-5-20251001
opus	anthropic	claude-opus-4-5-20251101
gemini	google	gemini-3-pro-preview
gemini-2.5	google	gemini-2.5-pro
deepseek	deepseek	deepseek-v4-pro
mistral	mistral	mistral-large-latest
grok	xai	grok-4-fast
grok-4	xai	grok-4-1-fast-reasoning
qwen	alibaba	qwen3-max
kimi, moonshot	moonshot	kimi-k2.7-code
glm	zai	glm-5