> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aihubmix.com/llms.txt
> Use this file to discover all available pages before exploring further.

# AI SDK - Proveedor Aihubmix

> Usa Aihubmix como proveedor de modelos grandes en el AI SDK y accede a una enorme cantidad de modelos con una única clave.

[Sitio web oficial](https://ai-sdk.dev/providers/community-providers/aihubmix)

## Funciones admitidas

El proveedor Aihubmix admite las siguientes funciones de IA, por lo que tu producto deja de estar limitado a estar impulsado únicamente por LLM:

* **Generación de texto**: Generar contenido de texto usando varios modelos
* **Streaming de texto**: Streaming de texto en tiempo real
* **Generación de imágenes**: Crear imágenes a partir de prompts de texto
* **Embeddings vectoriales**: Embeddings de texto individuales y por lotes
* **Generación de objetos**: Generación de datos estructurados
* **Streaming de objetos**: Streaming de datos estructurados en tiempo real
* **Síntesis de voz**: Texto a voz
* **Transcripción**: Voz a texto
* **Herramientas**: Búsqueda web y otras herramientas

## Instalación

Aihubmix está disponible en el módulo `@aihubmix/ai-sdk-provider`. Instálalo a través de [@aihubmix/ai-sdk-provider](https://www.npmjs.com/package/@aihubmix/ai-sdk-provider):

<CodeGroup>
  ```bash ai 4.3 theme={null}
  npm i @aihubmix/ai-sdk-provider@0.0.1
  ```

  ```bash ai 5 beta theme={null}
  npm i @aihubmix/ai-sdk-provider
  ```
</CodeGroup>

## Instancia del proveedor

Puedes importar la instancia de proveedor predeterminada, `aihubmix`, desde `@aihubmix/ai-sdk-provider`:

```ts theme={null}
import { aihubmix } from '@aihubmix/ai-sdk-provider';
```

## Configuración

Configura tu clave API de Aihubmix como variable de entorno para un acceso seguro:

```bash theme={null}
export AIHUBMIX_API_KEY="your-api-key-here"
```

O pásala directamente al proveedor:

```ts theme={null}
import { createAihubmix } from '@aihubmix/ai-sdk-provider';

const aihubmix = createAihubmix({
  apiKey: 'your-api-key-here',
});
```

## Uso

Importa las funciones necesarias:

```ts theme={null}
import { createAihubmix } from '@aihubmix/ai-sdk-provider';
import { 
  generateText, 
  streamText, 
  generateImage, 
  embed, 
  embedMany, 
  generateObject, 
  streamObject, 
  generateSpeech, 
  transcribe 
} from 'ai';
import { z } from 'zod';
```

Ejemplos de llamadas a varios tipos de generación con IA:

<CodeGroup>
  ```ts Generate Text theme={null}
  import { aihubmix } from '@aihubmix/ai-sdk-provider';
  import { generateText } from 'ai';

  const { text } = await generateText({
    model: aihubmix('o4-mini'),
    prompt: 'Write a vegetarian lasagna recipe for 4 people.',
  });
  ```

  ```ts Claude Model theme={null}
  import { aihubmix } from '@aihubmix/ai-sdk-provider';
  import { generateText } from 'ai';

  const { text } = await generateText({
    model: aihubmix('claude-3-7-sonnet-20250219'),
    prompt: 'Explain quantum computing in simple terms.',
  });
  ```

  ```ts Gemini Model theme={null}
  import { aihubmix } from '@aihubmix/ai-sdk-provider';
  import { generateText } from 'ai';

  const { text } = await generateText({
    model: aihubmix('gemini-2.5-flash'),
    prompt: 'Create a Python script to sort a list of numbers.',
  });
  ```

  ```ts Stream Text theme={null}
  import { aihubmix } from '@aihubmix/ai-sdk-provider';
  import { streamText } from 'ai';

  const result = streamText({
    model: aihubmix('gpt-3.5-turbo'),
    prompt: 'Write a short story about a robot learning to paint.',
    maxOutputTokens: 256,
    temperature: 0.3,
    maxRetries: 3,
  });

  let fullText = '';
  for await (const textPart of result.textStream) {
    fullText += textPart;
    process.stdout.write(textPart);
  }

  console.log('\nUsage:', await result.usage);
  console.log('Finish Reason:', await result.finishReason);
  ```

  ```ts Generate Object theme={null}
  import { aihubmix } from '@aihubmix/ai-sdk-provider';
  import { generateObject } from 'ai';
  import { z } from 'zod';

  const result = await generateObject({
    model: aihubmix('gpt-4o-mini'),
    schema: z.object({
      recipe: z.object({
        name: z.string(),
        ingredients: z.array(
          z.object({
            name: z.string(),
            amount: z.string(),
          }),
        ),
        steps: z.array(z.string()),
      }),
    }),
    prompt: 'Generate a lasagna recipe.',
  });

  console.log(JSON.stringify(result.object.recipe, null, 2));
  console.log('Token Usage:', result.usage);
  console.log('Finish Reason:', result.finishReason);
  ```

  ```ts Stream Object theme={null}
  import { aihubmix } from '@aihubmix/ai-sdk-provider';
  import { streamObject } from 'ai';
  import { z } from 'zod';

  const result = await streamObject({
    model: aihubmix('gpt-4o-mini'),
    schema: z.object({
      recipe: z.object({
        name: z.string(),
        ingredients: z.array(
          z.object({
            name: z.string(),
            amount: z.string(),
          }),
        ),
        steps: z.array(z.string()),
      }),
    }),
    prompt: 'Generate a lasagna recipe.',
  });

  for await (const objectPart of result.partialObjectStream) {
    console.log(objectPart);
  }

  console.log('Token Usage:', result.usage);
  console.log('Final Object:', result.object);
  ```

  ```ts Tool Calling theme={null}
  // The Aihubmix provider supports various tools, including web search:
  import { aihubmix } from '@aihubmix/ai-sdk-provider';
  import { generateText } from 'ai';

  const { text } = await generateText({
    model: aihubmix('gpt-4'),
    prompt: 'What are the latest developments in AI?',
    tools: {
      webSearchPreview: aihubmix.tools.webSearchPreview({
        searchContextSize: 'high',
      }),
    },
  });
  ```

  ```ts Image Generation theme={null}
  import { aihubmix } from '@aihubmix/ai-sdk-provider';
  import { generateImage } from 'ai';

  const { image } = await generateImage({
    model: aihubmix.image('gpt-image-1'),
    prompt: 'A beautiful sunset in the mountains',
  });
  ```

  ```ts Speech Synthesis theme={null}
  import { aihubmix } from '@aihubmix/ai-sdk-provider';
  import { generateSpeech } from 'ai';

  const { audio } = await generateSpeech({
    model: aihubmix.speech('tts-1'),
    text: 'Hello, this is a test of speech synthesis.',
  });

  // Save the audio file
  await saveAudioFile(audio);
  console.log('Audio generated successfully:', audio);
  ```

  ```ts Transcription theme={null}
  import { aihubmix } from '@aihubmix/ai-sdk-provider';
  import { transcribe } from 'ai';

  const { text } = await transcribe({
    model: aihubmix.transcription('whisper-1'),
    audio: audioFile,
  });
  ```

  ```ts Vector Embedding theme={null}
  import { aihubmix } from '@aihubmix/ai-sdk-provider';
  import { embed } from 'ai';

  const { embedding } = await embed({
    model: aihubmix.embedding('text-embedding-ada-002'),
    value: 'Hello, world!',
  });
  ```

  ```ts Batch Embedding theme={null}
  import { aihubmix } from '@aihubmix/ai-sdk-provider';
  import { embedMany } from 'ai';

  const { embeddings, usage } = await embedMany({
    model: aihubmix.embedding('text-embedding-3-small'),
    values: [
      'A sunny day at the beach',
      'A rainy afternoon in the city',
      'A snowy night in the mountains',
    ],
  });

  console.log('Embeddings:', embeddings);
  console.log('Usage:', usage);
  ```
</CodeGroup>

## Recursos relacionados:

* [Proveedor Aihubmix](https://v5.ai-sdk.dev/providers/community-providers/aihubmix)
* [AI SDK](https://ai-sdk.dev/docs)

***

Última actualización: 2026-06-01