Home
Learning
Quick start

Quick start

Your first AI API call in 5 minutes

Create a free account, make an API key and send one POST request. This example sends a customer message to the Intent Detection API and gets back the intent, a confidence score and the details it found, as JSON.

Create free account Try it in the playground

Free plan with 100 credits/month + 1,000 bonus credits when you sign in before 23 Nov
One key for every endpoint
Any language that speaks HTTPS

POST /api/v1/ai/intent-detection

{
    "text": "I want to cancel my subscription and review my invoices.",
    "intent_types": [
        "cancel_subscription",
        "billing_issue",
        "upgrade_plan"
    ]
}

200 OK response.json

{
    "success": true,
    "request_id": "req_7f3a9c2d1e4b8a6f",
    "data": {
        "result": {
            "intent": "cancel_subscription",
            "confidence": 0.98,
            "entities": {
                "action": "cancel",
                "target": "subscription"
            }
        }
    },
    "meta": {
        "version": "v1",
        "timestamp": "2026-09-27T12:34:56+00:00"
    }
}

Four steps

From sign-up to first result

1
Create a free account

Sign up with email or GitHub. Free plan with 100 credits/month + 1,000 bonus credits when you sign in before 23 Nov.
2
Create an API key

Open Dashboard > API Keys and create a key. Keep it on your server, never in browser code.
3
Send one POST request

Send JSON with your key in the x-api-key header. Copy the example below in your language.
4
Read the JSON result

Every endpoint answers with the same envelope, so the same code handles every task.

Step 3

Send the request in your language

Put your key in RSFLOWHUB_API_KEY (or in place of YOUR_API_KEY for cURL) and run it. Prefer an SDK? See the official SDKs.

request.sh

curl -X POST "https://rsflowhub.com/api/v1/ai/intent-detection" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{
    "text": "I want to cancel my subscription and review my invoices.",
    "intent_types": ["cancel_subscription", "billing_issue", "upgrade_plan"]
  }'

IntentController.php

use Illuminate\Support\Facades\Http;

$response = Http::withHeaders(['X-API-Key' => env('RSFLOWHUB_API_KEY')])
    ->timeout(10)
    ->post('https://rsflowhub.com/api/v1/ai/intent-detection', [
        'text' => 'I want to cancel my subscription and review my invoices.',
        'intent_types' => ['cancel_subscription', 'billing_issue', 'upgrade_plan'],
    ]);

$result = $response->json('data.result'); // ['intent' => 'cancel_subscription', ...]

intent.js

const response = await fetch('https://rsflowhub.com/api/v1/ai/intent-detection', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'X-API-Key': process.env.RSFLOWHUB_API_KEY,
  },
  body: JSON.stringify({
    text: 'I want to cancel my subscription and review my invoices.',
    intent_types: ['cancel_subscription', 'billing_issue', 'upgrade_plan'],
  }),
});

const { data } = await response.json();
console.log(data.result.intent); // "cancel_subscription"

intent.py

import os
import requests

response = requests.post(
    "https://rsflowhub.com/api/v1/ai/intent-detection",
    headers={"X-API-Key": os.environ["RSFLOWHUB_API_KEY"]},
    json={
        "text": "I want to cancel my subscription and review my invoices.",
        "intent_types": ["cancel_subscription", "billing_issue", "upgrade_plan"],
    },
    timeout=10,
)

print(response.json()["data"]["result"]["intent"])  # cancel_subscription

Step 4: read the result

Every endpoint returns the same envelope. Check success, then read data.result.

success boolean: true when the call worked, false on any error.
request_id string: Unique id for this call. Quote it when you contact support.
data.result object: The result of the endpoint, here the intent, confidence and entities.
error object: Only on failure: code, message and details per field.
meta object: API version and server timestamp.

Before you go live

Three things to set up for production

Set a client timeout

Give each call a clear timeout (AI calls usually take 1 to 3 seconds) so a slow request never blocks your app.

Retry 429s politely

On HTTP 429, wait for the Retry-After header, then retry with a small random delay.

Use one key per environment

Separate keys for local, staging and production, so you can revoke one without touching the others.

What next

Keep building

Browse the API catalog Sentiment, moderation, PII redaction, translation, ticket triage and more. Try it in the playground Run any endpoint in your browser and copy the code it writes for you. Use an official SDK PHP, JavaScript and Python clients with typed errors and retries. Handle errors Every error code, what it means and what to do next.

FAQ

Quick start questions

The full guide with every option is in the docs quick start.

How quickly can I make my first AI API call?

In a few minutes. Create a free RSFlowHub account, create an API key in Dashboard > API Keys, and run one of the code examples on this page.

What HTTP headers do I need?

Send "Content-Type: application/json" and "x-api-key: YOUR_API_KEY". "Authorization: Bearer YOUR_API_KEY" also works.

Can I test API calls without writing code?

Yes. The API playground lets you pick any endpoint, edit the request, see the JSON response and the credit cost, without writing code.

Is there an official SDK?

Yes, for PHP (composer require rsflowhub/rsflowhub-php), JavaScript and TypeScript (npm install rsflowhub) and Python (pip install rsflowhub). Plain HTTPS works from any other language.

Get your API key

Free plan with 100 credits/month + 1,000 bonus credits when you sign in before 23 Nov. Your first call is a few minutes away.

Create free account Read the docs

Your first AI API call in 5 minutes

Create a free account

Create an API key

Send one POST request

Read the JSON result

Step 4: read the result

Set a client timeout

Retry 429s politely

Use one key per environment

Get your API key