Platform APIs¶

Build with Pauhu. Comprehensive REST APIs for translation, document processing, and compliance. Type-safe SDKs for Python, TypeScript, Go, and Rust.

Base URL¶

https://api.pauhu.ai/v1

All API requests must be made over HTTPS. Requests over HTTP will fail.

Quick Start¶

from pauhu import Pauhu

client = Pauhu(api_key="pk_...")

result = client.translate(
    text="Hello, world!",
    target="fi"
)

print(result.translation)
# "Hei, maailma!"

import { Pauhu } from '@pauhu/sdk';

const client = new Pauhu({ apiKey: 'pk_...' });

const result = await client.translate({
  text: 'Hello, world!',
  target: 'fi'
});

console.log(result.translation);
// "Hei, maailma!"

curl -X POST https://api.pauhu.ai/v1/translate \
  -H "Authorization: Bearer pk_..." \
  -H "Content-Type: application/json" \
  -d '{"text": "Hello, world!", "target": "fi"}'

import "github.com/pauhu/pauhu-go"

client := pauhu.NewClient("pk_...")

result, err := client.Translate(ctx, &pauhu.TranslateRequest{
    Text:   "Hello, world!",
    Target: "fi",
})

fmt.Println(result.Translation)
// "Hei, maailma!"

API Sections¶

Authentication¶

All API requests require authentication using an API key:

Authorization: Bearer pk_your_api_key_here

Learn about authentication

Response Format¶

All responses are JSON with consistent structure:

Success Response¶

{
  "data": {
    "translation": "Hei, maailma!",
    "source_language": "en",
    "target_language": "fi",
    "confidence": 0.98
  },
  "meta": {
    "request_id": "req_abc123",
    "processing_time_ms": 45,
    "model": "pauhu-v3-eu"
  }
}

Error Response¶

{
  "error": {
    "code": "invalid_api_key",
    "message": "The API key provided is invalid.",
    "status": 401
  },
  "meta": {
    "request_id": "req_abc123"
  }
}

Rate Limits¶

Rate limit headers:

X-RateLimit-Limit: 600
X-RateLimit-Remaining: 599
X-RateLimit-Reset: 1705312800

Rate limits details

Versioning¶

The API is versioned via URL path:

https://api.pauhu.ai/v1/translate

• v1 - Current stable version
• Breaking changes result in new major versions
• Minor updates are backwards-compatible

OpenAPI Specification¶

Download the complete OpenAPI 3.1 specification:

• openapi.json
• openapi.yaml

Use with tools like Postman, Insomnia, or generate clients.

OpenAPI details

Environments¶

Support¶

• API Reference
• GitHub Issues
• api-support@pauhu.ai
• Developer Slack