oatda-generate-image

OATDA Image Generation

Generate images from text descriptions using AI models through OATDA's unified API.

When to Use

Use this skill when the user wants to:

• Generate images from text descriptions via OATDA
• Create AI artwork, illustrations, or designs
• Generate product mockups or concept art
• Use DALL-E, Imagen, or other image models through a single API

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 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

Map common aliases:

User says	Provider	Model
dall-e, dall-e-3 (default)	openai	dall-e-3
gpt-image	openai	gpt-image-1
imagen	google	imagen-4.0-generate-001
seedream	bytedance	seedream-4-5-251128
wan	alibaba	wan2.6-t2i
minimax image	minimax	image-01
grok image	xai	grok-imagine-image

Default: openai / dall-e-3 if no model specified.