The shortest path to using Fikra API from an agent is a copy-paste prompt, not a dashboard tour. The
agent reads the guide, asks for one email address, and does the rest.
The prompt
Give this to an agent that can make HTTP calls:
Read https://fikraapi.co.ke/for-agents and follow it. You are operating for me. Ask me for the email
to use, then open a Fikra API account with POST /v1/agents/accounts. Use the delegated token to mint an
API key and fund the wallet. Default is $10, or pay in KES by M-Pesa with my phone number. Then use the
key for chat, images, video, audio, batch and the fixed-price tools. Send me the claim link so I can set
a password and own the account. Do not ask for my card. Start now and report the claim link, the balance
and each receipt id.
What the agent does
- Creates the provisional account and receives a scoped six-hour token.
- Mints an API key with the token.
- Quotes the first call so the spend is known before it happens.
- Funds the wallet by card, M-Pesa, or x402 USDC on Base.
- Runs the work and records a receipt for each paid call.
- Sends you the claim link, the balance, and the receipt ids.
What you do
Open the claim link, set a password, and the account is yours. The agent's token expires on its own.
You can revoke the key at any time and the wallet balance stays with the account.
Why this exists
African builders often run agents from a phone or a small VPS, where a browser checkout is the slowest
part of the job. Agents for humans removes that step for the agent and keeps the human in control of
the account at the end. Every call is priced from the same registry the website publishes, so the quote,
the invoice, and the request record agree.
Read the full guide at fikraapi.co.ke/for-agents or
check the Fikra API homepage for the live model catalog.