Skip to content
Scalekit Docs
Talk to an Engineer Dashboard

Connect AI agents to Claid AI

Scalekit connector
Open markdown

The Claid AI connector lets your AI agent act in each user's Claid AI account. Each user connects their own Claid AI access token once, and Scalekit sends it with every call, so your agent never handles credentials. It comes with 17 tools.

Tools
17
What they doRead · write · destructive
8 · 8 · 18 read8 write1 destructive
Users sign in with

Setup

  1. Install the SDK

    Terminal window
    npm install @scalekit-sdk/node dotenv
  2. Set your credentials

    Add your Scalekit credentials to your .env file. Find values in app.scalekit.com > Developers > API Credentials.

    .env
    SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
    SCALEKIT_CLIENT_ID=<your-client-id>
    SCALEKIT_CLIENT_SECRET=<your-client-secret>
  3. Create the Claid AI connection

    In AgentKit > Connections, create a Claid AI connection. The name you give it is the connection_name your code passes. See Configure connections.

  4. Authorize a user and make your first call

    quickstart.mts
    import { ScalekitClient } from '@scalekit-sdk/node'
    import 'dotenv/config'
    import { createInterface } from 'node:readline/promises'
    const scalekit = new ScalekitClient(
    process.env.SCALEKIT_ENVIRONMENT_URL,
    process.env.SCALEKIT_CLIENT_ID,
    process.env.SCALEKIT_CLIENT_SECRET,
    )
    const actions = scalekit.actions
    const connector = 'claid'
    const identifier = 'user_123'
    // Generate an authorization link for the user
    const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
    console.log('Authorize Claid AI:', link)
    const rl = createInterface({ input: process.stdin, output: process.stdout })
    await rl.question('Press Enter after authorizing...')
    rl.close()
    // Make your first call
    const result = await actions.executeTool({
    connector,
    identifier,
    toolName: 'claid_storage_types_list',
    toolInput: {},
    })
    console.log(result)
    Terminal window
    npx tsx quickstart.mts

    Each user opens the link once and enters their Claid AI credentials there. See Authorize a user for the full flow and statuses.

Tools

Pass the exact name to execute_tool
Try in PlaygroundRequest a tool
  • claid_ai_edit_getGet the status and result of an AI image edit.Read-only

    Get AI Image Edit

    Get the status and result of an AI image edit. Returns the task status and, when done, the output image URLs. Poll it after ai_edit_create.

    Inputs

    task_idintegerrequired
    ID of the AI edit task, from the id in the create tool's response. Example: 4521.
  • claid_fashion_models_getGet the status and result of an AI fashion models task.Read-only

    Get AI Fashion Model Photos

    Get the status and result of an AI fashion models task. Returns the task status and, when done, the generated image URLs. Poll it after fashion_models_create.

    Inputs

    task_idintegerrequired
    ID of the AI fashion models task, from the id in the create tool's response. Example: 4521.
  • claid_image_edit_async_getGet the status and result of an asynchronous image edit.Read-only

    Get Async Image Edit

    Get the status and result of an asynchronous image edit. Returns the task status (ACCEPTED, PROCESSING, DONE or ERROR) and, when done, the output image details and URL. Poll it after image_edit_async.

    Inputs

    task_idintegerrequired
    ID of the async image edit task, from the id in the create tool's response. Example: 4521.
  • claid_image_edit_batch_getGet the status and results of a batch image edit.Read-only

    Get Batch Image Edit

    Get the status and results of a batch image edit. Returns the task status and, per processed image, its input, output and any error. Poll it after image_edit_batch.

    Inputs

    task_idintegerrequired
    ID of the batch image edit task, from the id in the create tool's response. Example: 4521.
  • claid_storage_getGet one connected storage.Read-only

    Get Storage

    Get one connected storage. Returns its name, type and settings (without secrets). Use storages_list to find storage IDs.

    Inputs

    storage_idintegerrequired
    ID of the storage, from storages_list. Example: 12.
  • claid_storage_types_listList the storage types Claid can connect to (such as AWS S3, Google Cloud Storage and web folders).Read-only

    List Storage Types

    List the storage types Claid can connect to (such as AWS S3, Google Cloud Storage and web folders). Returns each type's name and required settings. Storages are connected in the Claid dashboard.

    Inputs

    This tool takes no inputs.

  • claid_storages_listList the external storages connected to your Claid account.Read-only

    List Storages

    List the external storages connected to your Claid account. Returns each storage's id, name, type and settings (without secrets). Use a storage name in storage:// URIs for input and output.

    Inputs

    This tool takes no inputs.

  • claid_video_getGet the status and result of an image-to-video task.Read-only

    Get Video Generation

    Get the status and result of an image-to-video task. Returns the task status and, when done, the video URL. Poll it after video_generate.

    Inputs

    task_idintegerrequired
    ID of the video generation task, from the id in the create tool's response. Example: 4521.