🔌

API Documentation

Use Helliduck's AI features in your own apps. Free tier: 100 calls/month.

Authentication

Include your API key in the x-api-key header:

curl -X POST https://helliduck.com/api/v1/fortune \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{}'

POST/api/v1/excuse

Generate an AI-crafted excuse

Request body:

{ "situation": "string", "believability": 0-100 }

Response:

{ "excuse": "...", "believability_actual": 75, "duck_comment": "..." }

POST/api/v1/fortune

Get a brutally honest fortune

Request body:

{}

Response:

{ "fortune": "...", "lucky_numbers": [1,2,3,4,5,6], "duck_wisdom": "..." }

POST/api/v1/judge

Settle an argument

Request body:

{ "sideA": "string", "sideB": "string" }

Response:

{ "winner": "A|B|neither", "verdict": "...", "roast_a": "...", "roast_b": "...", "confidence": 85 }

POST/api/v1/rate

Rate a life decision

Request body:

{ "decision": "string" }

Response:

{ "ratings": { "boldness": 8, ... }, "overall_score": 7, "summary": "...", "duck_advice": "..." }

POST/api/v1/dare

Get a random dare

Request body:

{}

Response:

{ "dare": "...", "difficulty": "easy|medium|hard", "embarrassment_level": 7, "duck_taunt": "..." }

POST/api/v1/roast

Roast a website

Request body:

{ "url": "https://example.com" }

Response:

{ "design_roast": "...", "performance_roast": "...", "seo_roast": "...", "copy_roast": "...", "ducked_score": 45, "one_liner": "..." }

POST/api/v1/meme

Generate meme captions

Request body:

{ "template": "Drake Hotline Bling", "context": "optional topic" }

Response:

{ "top_text": "...", "bottom_text": "..." }

POST/api/v1/clapback

Get a comeback for a roast you received

Request body:

{ "roast": "the roast someone sent you" }

Response:

{ "clapback": "...", "mic_drop": "...", "alternatives": ["...", "..."], "savageness": 8, "duck_commentary": "..." }

Want an API key? Email Oye1810@gmail.com (or just use the website for free).