Skip to main content

​
1. Get Your API Key

  1. Subscribe to Rose Labs at roselabs.ai
  2. Navigate to Settings > API Keys
  3. Copy your API key

​
2. Create an Agent

curl -X POST "https://navi-j9a9.onrender.com/api/agents" \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
    "goal": "Find the current price of Bitcoin and Ethereum",
    "model": "rose-1-lite"
  }'

​
Response

{
  "agent_id": "550e8400-e29b-41d4-a716-446655440000",
  "goal": "Find the current price of Bitcoin and Ethereum",
  "model": "rose-1-lite",
  "status": "ACTIVE",
  "progress": 0,
  "created_at": "2024-01-15T10:30:00Z"
}

​
3. Poll for Results

Agents work asynchronously. Poll the status endpoint to check progress and retrieve messages. 
curl "https://navi-j9a9.onrender.com/api/agents/550e8400-e29b-41d4-a716-446655440000" \
  -H "x-api-key: YOUR_API_KEY"

​
Response

{
  "agent": {
    "agent_id": "550e8400-e29b-41d4-a716-446655440000",
    "status": "COMPLETED",
    "progress": 1.0,
    "token_count": 1520,
    "message_count": 4
  },
  "messages": [
    {
      "role": "USER",
      "text": "Find the current price of Bitcoin and Ethereum"
    },
    {
      "role": "ASSISTANT",
      "text": "I'll search for the current cryptocurrency prices..."
    },
    {
      "role": "ASSISTANT",
      "text": "Current prices:\n- Bitcoin: $97,432\n- Ethereum: $3,891"
    }
  ]
}

​
4. Choose Your Model

ModelBest ForCost
rose-1-liteFast tasks, simple researchLower cost
rose-1-ultraComplex reasoning, detailed analysisHigher quality
See Models for detailed pricing.

​
Next Steps