API Documentation

Build with Artfrika — Generate African-inspired designs programmatically

Get Started View Examples on GitHub →

Base URL

https://api.artfrika.com/v1

Authentication

Bearer Token in Authorization header

Rate Limits

60 requests / minute (free tier)
Higher tiers available

Authentication

All API requests require authentication using an API key.

Authorization: Bearer YOUR_API_KEY

Get your API key from Dashboard → API Keys

Generate Design

POST/designs/generate

Request Body

{
  "prompt": "Yoruba adire pattern on modern hoodie, vibrant indigo and white",
  "style": "traditional-modern",
  "aspectRatio": "3:4",
  "quality": "high",
  "count": 4
}

Response (200 OK)

{
  "requestId": "req_abc123",
  "status": "completed",
  "designs": [
    {
      "id": "des_001",
      "url": "https://cdn.artfrika.com/...",
      "thumbnail": "..."
    }
  ],
  "creditsUsed": 4,
  "remainingCredits": 996
}