퀵스타트

PixAI API로 실행하고 시작

PixAI API는 GraphQL 엔드포인트를 통해 가장 쉽게 액세스할 수 있습니다. 모든 GraphQL 클라이언트를 사용하여 API와 상호 작용할 수 있습니다. 또는 간단한 HTTP 엔드포인트로도 사용할 수 있습니다.

하지만 가장 쉽게 시작할 수 있는 방법은 SDK를 사용하는 것입니다.

저희가 다음 언어를 위한 SDK를 제공합니다:

• JavaScript
• Golang

각 저장소의 지침을 따라 시작할 수 있습니다.

대부분의 SDK는 메인 인터페이스 호출을 위한 비교적 완벽한 캡슐화를 제공합니다.

클라이언트 설정

다음은 JavaScript 언어를 사용하는 예시입니다:

API 키를 클라이언트에게 전달하기만 하면 됩니다. 이 모든 것을 준비하시면 시작할 수 있습니다.

JavaScript

import PixAIClient from 'pixai-client-js'

const client = new PixAIClient({
  apiKey: 'YOUR_API_KEY',
})

Golang

package main

import (
  pixai_client "github.com/pixai-art/pixai-client-go"
)

func main() {
  client := pixai_client.NewPixAIClient().
    SetApiKey("YOUR_API_KEY").
    Init()
}

주의

플랫폼에 액세스할 수 있는 경우 프로필 편집 페이지에서 액세스 토큰을 만들 수 있습니다. 액세스 토큰에는 많은 권한이 있으므로 보안을 유지하세요! GitHub, client-side code 등 공개적으로 액세스할 수 있는 영역에서는 비밀 API 키를 공유하지 마세요.

이미지 생성 시작

클라이언트를 설정한 후 이미지 생성을 시작할 수 있습니다. 다음은 텍스트 대 이미지로 이미지를 생성하는 예입니다.

JavaScript

주의

generateImagegenerateImage는 WebSocket을 사용하여 작업 업데이트를 가져옵니다. 클라이언트 생성자에게 webSocketImpl 매개변수를 전달해야 합니다. WebSocket을 사용하지 않으려면 createGenerationTask를 사용하여 작업을 생성하고 작업 상태를 폴링할 수 있습니다.

const task = await client.generateImage(
  {
    prompts: '1girl',
    modelId: '1648918127446573124',
    width: 512,
    height: 512,
  },
)
console.log('Task completed: ', task)

Golang

  params := pixai_client.JSONObject{
    "width":   512,
    "height":  512,
    "prompts": "miku",
    "modelId": "1648918127446573124",
  }

  ctx := context.Background()

  task, err := client.GenerateImage(ctx, params, func(task *pixai_client.TaskBase) {
    fmt.Printf("Task Updated: %+v\n", task)
  })
  if err != nil {
    fmt.Printf("Error: %+v\n", err)
    return
  }

주의

모델 페이지에서 modelId를 가져오는 방법을 배울 수 있습니다.

결과

작업에는 많은 정보가 있습니다. 생성된 이미지만 가져오려면 다음 코드를 참조하면 됩니다.

JavaScript

const media = await client.getMediaFromTask(task)

Golang

  media, err := client.GetMediaFromTask(ctx, task)
  if err != nil {
    fmt.Printf("Error: %+v\n", err)
    return
  }

이미지 다운로드

JavaScript SDK에서 획득한 미디어는 매개변수의 batch에 따라 하나 이상의 이미지를 포함할 수 있습니다. 이미지를 하나만 생성한 경우 미디어가 하나뿐이라고 주장할 수 있습니다.

그 후, 내장된 방법을 사용하여 미디어의 내용에 대한 걱정 없이 이미지를 직접 다운로드할 수 있습니다.

JavaScript

assert(media && !Array.isArray(media))

const buffer = await client.downloadMedia(media)

await fs.writeFile('output.png', Buffer.from(buffer))

Golang

  file, mimeType, err := client.DownloadMedia(ctx, media[0])
  if err != nil {
    fmt.Printf("Error: %+v\n", err)
    return
  }
  ext, _ := mime.ExtensionsByType(mimeType)
  err = os.WriteFile("output"+ext[0], file, 0644)
  if err != nil {
    fmt.Printf("Error: %+v\n", err)
    return
  }

다음 단계

위의 내용은 API 사용을 시작하는 가장 빠른 방법입니다. 자세한 정보나 사용 방법을 알고 싶으시면 이 사이트의 SDK 문서 및 기타 문서를 참고하시길 바랍니다.