# AI SDK – AIMLAPI Provider

[![npm version](https://img.shields.io/npm/v/%40ai-ml.api%2Faimlapi-vercel-ai?color=blue&label=npm)](https://www.npmjs.com/package/@ai-ml.api/aimlapi-vercel-ai)
[![npm downloads](https://img.shields.io/npm/dm/%40ai-ml.api%2Faimlapi-vercel-ai?color=brightgreen)](https://www.npmjs.com/package/@ai-ml.api/aimlapi-vercel-ai)
[![license](https://img.shields.io/npm/l/%40ai-ml.api%2Faimlapi-vercel-ai)](LICENSE)

The **[AIMLAPI Provider](https://ai-sdk.dev/providers/community-providers/aimlapi)** for the [AI SDK](https://ai-sdk.dev/docs) allows you to access **300+ AI models** from the [AI/ML API](https://aimlapi.com/?utm_source=aimlapi-vercel-ai&utm_medium=github&utm_campaign=integration) with enterprise-grade rate limits and uptime.

> AI/ML API offers models including DeepSeek, Gemini, ChatGPT — all via an OpenAI-compatible API.  
> Model browser: [https://aimlapi.com/models](https://aimlapi.com/models/?utm_source=aimlapi-vercel-ai&utm_medium=github&utm_campaign=integration)  
> API endpoint: [https://api.aimlapi.com/v1/](https://api.aimlapi.com/v1/)

- **Dashboard:** [https://aimlapi.com/app](https://aimlapi.com/app/?utm_source=aimlapi-vercel-ai&utm_medium=github&utm_campaign=integration)  
- **API Docs:** [https://docs.aimlapi.com](https://docs.aimlapi.com/?utm_source=aimlapi-vercel-ai&utm_medium=github&utm_campaign=integration)

---

## Requirements
- Node.js **18+**
- AI SDK **latest**
- [AIMLAPI API Key](https://aimlapi.com/app/?utm_source=aimlapi-vercel-ai&utm_medium=github&utm_campaign=integration)

---

## Installation

```bash
npm install @ai-ml.api/aimlapi-vercel-ai
# or
pnpm add @ai-ml.api/aimlapi-vercel-ai
# or
yarn add @ai-ml.api/aimlapi-vercel-ai
````

### API Key

```bash
export AIMLAPI_API_KEY=sk-...
```

---

## Usage

### Import

```ts
import { aimlapi } from '@ai-ml.api/aimlapi-vercel-ai';
```

### Quickstart

```ts
import { aimlapi } from '@ai-ml.api/aimlapi-vercel-ai';
import { generateText } from 'ai';

const { text } = await generateText({
  model: aimlapi('gpt-3.5-turbo'),
  prompt: 'Hello from AIMLAPI!',
});

console.log(text);
```

---

## Using GPT-4o

```ts
import 'dotenv/config';
import { generateText } from 'ai';
import { aimlapi } from '@ai-ml.api/aimlapi-vercel-ai';

const { text } = await generateText({
  model: aimlapi('gpt-4o'),
  system: 'You are a friendly assistant!',
  prompt: 'Why is the sky blue?',
});

console.log(text);
```

---

## Image Generation

```ts
import 'dotenv/config';
import { aimlapi } from '@ai-ml.api/aimlapi-vercel-ai';

async function main() {
  const model = aimlapi.imageModel('flux-pro');

  const res = await model.doGenerate({
    prompt: 'a red balloon floating over snowy mountains, cinematic',
    n: 1,
    aspectRatio: '16:9',
    seed: 42,
    size: '1024x768',
    providerOptions: {},
  });

  console.log(`✅ Generated image url: ${res.images[0]}`);
}

main().catch(console.error);
```

---

## Features

* ✅ Text generation (chat & completion)
* ✅ Image generation
* ✅ Embeddings
* ✅ OpenAI-compatible API

**Browse models:** [https://aimlapi.com/models](https://aimlapi.com/models/?utm_source=aimlapi-vercel-ai&utm_medium=github&utm_campaign=integration)

---

## License

Apache License 2.0