oib/aitbc
1
0
Fork 0
Code Issues Pull Requests Actions 6 Packages Projects Releases Wiki Activity
Files
9fb68683ed7cb8abec5ea559e1789f5a1c7c3bae
aitbc/docs/2_clients/6_api-reference.md
AITBC System b033923756 chore: normalize file permissions across repository 
- Remove executable permissions from configuration files (.editorconfig, .env.example, .gitignore)
- Remove executable permissions from documentation files (README.md, LICENSE, SECURITY.md)
- Remove executable permissions from web assets (HTML, CSS, JS files)
- Remove executable permissions from data files (JSON, SQL, YAML, requirements.txt)
- Remove executable permissions from source code files across all apps
- Add executable permissions to Python
2026-03-08 11:26:18 +01:00

1.7 KiB
Raw Blame History

Client API Reference

REST API endpoints for client operations.

Endpoints

Submit Job

POST /v1/jobs

Request Body:

{
  "model": "gpt2",
  "input": "string or file_id",
  "output_config": {
    "destination": "local or s3://bucket/path",
    "format": "json"
  },
  "requirements": {
    "gpu_type": "v100",
    "gpu_count": 1,
    "min_vram_gb": 16
  },
  "priority": "normal",
  "timeout_seconds": 3600
}

Response:

{
  "job_id": "job_abc123",
  "estimated_cost": 0.05,
  "estimated_time_seconds": 600
}

Get Job Status

GET /v1/jobs/{job_id}

Response:

{
  "job_id": "job_abc123",
  "status": "running",
  "progress": 45,
  "miner_id": "miner_xyz789",
  "created_at": "2026-02-13T10:00:00Z",
  "started_at": "2026-02-13T10:01:00Z",
  "completed_at": null,
  "result": null
}

List Jobs

GET /v1/jobs?status=running&limit=10

Response:

{
  "jobs": [
    {
      "job_id": "job_abc123",
      "status": "running",
      "model": "gpt2"
    }
  ],
  "total": 1,
  "has_more": false
}

Cancel Job

DELETE /v1/jobs/{job_id}

Download Results

GET /v1/jobs/{job_id}/download

Get Job History

GET /v1/jobs/history?from=2026-01-01&to=2026-01-31

Error Codes

Code Description
400 Invalid request
401 Unauthorized
404 Job not found
422 Validation error
429 Rate limited
500 Server error

Rate Limits

  • 60 requests/minute
  • 1000 requests/hour

Next