KEPLIN Docs

Afbeeldingen en audio

Afbeeldingen genereren met ai.image, opnames transcriberen met ai.transcribe en spraak genereren met ai.speak.

Elke bewerking gebruikt een alias van het juiste gebruik: Afbeeldingen voor ai.image, Transcriptie voor ai.transcribe en Spraak voor ai.speak. Zonder model= geldt de standaardalias van dat gebruik. Niet elke provider doet deze bewerkingen: zie Wat elke provider doet.

Afbeeldingen genereren

from api_manager import ai


def main(input):
    r = ai.image(
        "Fotografia de produto de uma cadeira de madeira, fundo branco",
        size="1024x1024",
        filename="cadeira",
    )
    return {"ficheiro": r["file"]}  # {"token", "filename", "mime", "size"}
  • De afbeeldingen gaan rechtstreeks naar de opslag van de app. Elke afbeelding komt als het bestand dat files.store teruggeeft (token, filename, mime en size), klaar om in een veld van een record op te slaan. Voor de bytes gebruikt u files.read(r["file"]).
  • size is breedte x hoogte, bijvoorbeeld 1024x1024. Bij Google wordt de grootte de dichtstbijzijnde verhouding (1:1, 3:4, 4:3, 9:16 of 16:9).
  • n genereert tot 4 afbeeldingen tegelijk. r["files"] bevat ze allemaal; r["file"] is de eerste.
  • filename is de bestandsnaam, zonder extensie; zonder deze heet het bestand imagem. De extensie volgt uit het type van de afbeelding.
  • Als de veiligheidsfilters van de provider het verzoek blokkeren, gooit ai.image ai.Error met de code invalid_output.

Audio transcriberen

from api_manager import ai


def main(input):
    gravacao = input["args"]["gravacao"]  # een argument van het type Upload van een API
    t = ai.transcribe(gravacao, language="pt", prompt="Keplin, Gestão de Clientes")
    return {"texto": t["text"]}
  • Het bestand is een argument van het type Upload, de token ervan, of wat files.store teruggeeft.
  • Accepteert MP3, MP4, M4A, WAV, WEBM, OGG en FLAC, tot 25 MB (15 MB bij Google).
  • language is de gesproken taal, in twee letters (pt, en). Zonder deze herkent het model de taal zelf.
  • prompt helpt bij eigennamen, afkortingen en technische termen die in de opname voorkomen.

Spraak genereren

from api_manager import ai


def main(input):
    voz = ai.speak("A sua encomenda já saiu do armazém.", voice="alloy", filename="aviso")
    return {"ficheiro": voz["file"]}
  • De audio gaat naar de opslag van de app, en voz["file"] is het bestand, zoals bij ai.image. Zonder filename heet het bestand voz.
  • voice is de naam van een stem van de provider, bijvoorbeeld alloy of nova bij OpenAI en Kore of Puck bij Google. Zonder deze geldt alloy in het OpenAI-formaat en Kore bij Google.
  • format is mp3 (standaard), wav, opus, aac of flac. Google geeft altijd WAV terug.
  • instructions zegt hoe er gesproken wordt (toon, tempo, emotie), bij de modellen die dat ondersteunen.

Veelgestelde vragen

Kan ik een bestaande afbeelding bewerken? Nee: ai.image genereert nieuwe afbeeldingen op basis van tekst. Om een afbeelding te beschrijven of te analyseren, gebruikt u ai.chat met files=.

Kan ik een opname vertalen? Transcribeer die met ai.transcribe en vertaal de tekst met ai.chat.