Skip to content
Last updated

🔨 In Development — This section is still being developed and may change.
The OrganizationProvider object represents AI provider integrations for an organization. Each organization can integrate with multiple AI providers (OpenAI, Anthropic, etc.) with provider-specific credentials and configurations.

Properties

Composite Primary Key

organization_id string required

Reference to the Organization this provider integration belongs to.

provider_name string required

Name of the AI provider. One of: aitronos, openai, anthropic, clipdrop.

Provider Configuration

provider_org_id string | null optional

Provider's organization identifier (e.g., OpenAI organization ID).

provider_project_id string | null optional

Provider's project identifier (if applicable, e.g., OpenAI project ID).

provider_api_key string | null optional

Provider's API key (encrypted at rest). Used for authenticating requests to the provider.

Status

is_active boolean required

Whether this provider integration is active and can be used. Default: true.

Timestamps

created_at string required

Timestamp when the provider integration was created. Format: ISO 8601 datetime string.

updated_at string required

Timestamp when the provider integration was last updated. Format: ISO 8601 datetime string.

Supported Providers

Aitronos (Freddy)

  • Native Freddy AI models
  • Models: ftg-2.0, ftg-2.0-mini, freddy-*
  • No external credentials required
  • Always enabled by default

OpenAI

  • GPT models and DALL-E
  • Models: gpt-4o, gpt-4o-mini, gpt-4-turbo, dall-e-3, dall-e-2
  • Requires: provider_api_key
  • Optional: provider_org_id, provider_project_id

Anthropic

  • Claude models
  • Models: claude-3-5-sonnet, claude-3-opus, claude-3-haiku
  • Requires: provider_api_key
  • Optional: provider_org_id

ClipDrop

  • Image operations (upscale, cleanup, background removal)
  • Models: clipdrop-text-to-image, clipdrop-upscale, clipdrop-cleanup, clipdrop-remove-background, clipdrop-replace-background
  • Requires: provider_api_key
  • Credit-based billing

Multi-Provider Support

Organizations can have multiple active provider integrations simultaneously:

  • Use OpenAI for GPT models
  • Use Anthropic for Claude models
  • Use Freddy for proprietary models

The system automatically routes requests to the appropriate provider based on the model selected.

Security

  • API keys are encrypted at rest
  • Keys are never exposed in API responses
  • Provider credentials are validated before activation
  • Failed authentication attempts are logged

OpenAI Integration

{
  "organization_id": "ORG_A1B2C3D4E5F6G7H8",
  "provider_name": "openai",
  "provider_org_id": "org-1234567890abcdef",
  "provider_project_id": "proj-abcdef1234567890",
  "provider_api_key": "[ENCRYPTED]",
  "is_active": true,
  "created_at": "2025-01-10T09:00:00Z",
  "updated_at": "2025-01-15T14:30:00Z"
}

Anthropic Integration

{
  "organization_id": "ORG_A1B2C3D4E5F6G7H8",
  "provider_name": "anthropic",
  "provider_org_id": "org-anthropic-xyz789",
  "provider_project_id": null,
  "provider_api_key": "[ENCRYPTED]",
  "is_active": true,
  "created_at": "2025-01-10T09:05:00Z",
  "updated_at": "2025-01-10T09:05:00Z"
}

Aitronos (Freddy) Integration (Native)

{
  "organization_id": "ORG_A1B2C3D4E5F6G7H8",
  "provider_name": "aitronos",
  "provider_org_id": null,
  "provider_project_id": null,
  "provider_api_key": null,
  "is_active": true,
  "created_at": "2025-01-10T09:00:00Z",
  "updated_at": "2025-01-10T09:00:00Z"
}

ClipDrop Integration

{
  "organization_id": "ORG_A1B2C3D4E5F6G7H8",
  "provider_name": "clipdrop",
  "provider_org_id": null,
  "provider_project_id": null,
  "provider_api_key": "[ENCRYPTED]",
  "is_active": true,
  "created_at": "2025-01-10T09:00:00Z",
  "updated_at": "2025-01-10T09:00:00Z"
}

Inactive Provider

{
  "organization_id": "ORG_A1B2C3D4E5F6G7H8",
  "provider_name": "openai",
  "provider_org_id": "org-old-1234567890",
  "provider_project_id": "proj-old-abcdef1234",
  "provider_api_key": "[ENCRYPTED]",
  "is_active": false,
  "created_at": "2025-01-05T08:00:00Z",
  "updated_at": "2025-01-14T16:45:00Z"
}