aimlapi-llm-reasoning

# AIMLAPI LLM + Reasoning

## Overview

Use `run_chat.py` to call AIMLAPI chat completions with retries, optional API key file fallback, and a `User-Agent` header on every request.

## Quick start

```bash
export AIMLAPI_API_KEY="sk-aimlapi-..."
python3 {baseDir}/scripts/run_chat.py --model aimlapi/openai/gpt-5-nano-2025-08-07 --user "Summarize this in 3 bullets."
```

## Tasks

### Run a basic chat completion

```bash
python3 {baseDir}/scripts/run_chat.py \
  --model aimlapi/openai/gpt-5-nano-2025-08-07 \
  --system "You are a concise assistant." \
  --user "Draft a project kickoff checklist." \
  --user-agent "openclaw-custom/1.0"
```

### Add reasoning parameters

```bash
python3 {baseDir}/scripts/run_chat.py \
  --model aimlapi/openai/gpt-5-nano-2025-08-07 \
  --user "Plan a 5-step rollout for a new chatbot feature." \
  --extra-json '{"reasoning": {"effort": "medium"}, "temperature": 0.3}'
```

### Structured JSON output

```bash
python3 {baseDir}/scripts/run_chat.py \
  --model aimlapi/openai/gpt-5-nano-2025-08-07 \
  --user "Return a JSON array of 3 project risks with mitigation." \
  --extra-json '{"response_format": {"type": "json_object"}}' \
  --output ./out/risks.json
```

## References

- `references/aimlapi-llm.md`: payload and troubleshooting notes.
- `README.md`: changelog-style summary of new instructions.

# aimlapi-llm-reasoning

This skill provides a helper script for AIMLAPI chat + reasoning workflows.

## Security & Credentials

- This skill requires an `AIMLAPI_API_KEY` environment variable.
- Be cautious when using the `--apikey-file` flag; ensure the provided path is correct and secure.
- Avoid including sensitive or private data in `--extra-json`, as this payload is sent to the remote API.

## New instructions

- Every HTTP request sends a `User-Agent` header (configurable via `--user-agent`).
- `run_chat.py` supports retries, API key from `--apikey-file`, and verbose logs.
- Use `--extra-json` for reasoning/tooling/provider-specific fields.

See `SKILL.md` for examples.